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‘ 
This publication describes the internal logic of the TSO TEST Command 
Processor. It contains text introductions, method-of-operation diagrams, program 
organization descriptions, a module directory, and data area formats. This 
publication is written for persons who maintain or modify TSO TEST. It is not 
required by those who use TSO TEST to process programs or who write programs 
that are processed by TSO TEST. 


This book is divided into seven sections, each containing a particular type of 
information, as follows: 


e “Section |: Introduction,” which describes the TEST program in general and 
its relationships to other parts of the TSO control program, and tells the reader 
where he may find descriptions of different parts of the program. It includes 
an overview of TEST logic. 


e ‘Section 2: Method of Operation,” which describes graphically how each 
functional area of the program works. The emphasis here is on function: what 
is done, why it is done, what tables and control blocks are used, and what 
interrelationships exist. System interfaces are indicated. 


e “Section 3: Program Organization,” which contains module descriptions. The 
module descriptions are arranged alphabetically by module entry name. The 
module descriptions contain reference information, such as register usage, 
system routines called, and return codes. 


e “Section 4: Directories,’’ which contains alphamerically organized lists of 
important internal symbols, entry names, and module names. Each name is 
defined and cross-referenced to the object module that contains the named 
item. 


e “Section 5: Data Areas,” which contains a brief description and the format of 
each major table and control block used by the TEST program. 


e “Section 6: Diagnostic Aids,’ which contains detailed information on how the 
TEST program handles STAE-intercepted abnormal terminations that occur in 
the TEST program. 


e “Section 7: Appendix,’ which describes the setting of pseudo breakpoints by 
particular TEST modules. 


Prerequisite Information 


The information in the following manuals, as they apply to the TEST command, 
should be understood before you read this publication: 


«© OS/VS2 TSO Command Language Reference, GC28-0646, which 
describes the format and meaning of the TEST command and its 
subcommands. 


e OS/VS2 TSO Guide to Writing a Terminal Monitor Program or a 
Command Processor, GC28-0648, which describes how to use the TEST 
command and its subcommands to test a new program. 


The following three books should be available for reference, while you are 
reading this publication: 


e OS/VS2 TSO Terminal Monitor Program and Service Routines Logic, 
SY28-0650, which describes linkages between the TEST program and the 
Terminal Monitor Program (TMP) and discusses in detail the TMP STAI Exit 
routine and the service routines. The service routines include: IKJPARS, 
IKJDAIR, IKJDELT, and the 1/O service routines invoked by the macro 
instructions STACK, GETLINE, PUTLINE, and PUTGET. 


Preface 3 


OS/VS2 Supervisor Logic, SY27-7244, which describes the logic of system 
services that the TEST program uses: exiting (SVC 3), dispatching, Contents 
Supervision, and the ABEND/STAE interface routines. 


¢ OS/VS2 TSO Control Program Logic, SY28-0649, which describes the ; 
operation of the attention handler (modules IKJVARO4 and IKJVAROS). 
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Section 1: introduction 


The TEST command processor, referred to as TEST in this publication, permits 
you to test a program that was written in assembler language or some other 
language that produces an assembler language listing. To perform its functions, 
TEST uses subcommands and service routines which are explained in this section. 
TEST may be invoked in any one of three situations, each of which is also 
described in this section. Finally, the relationship of TEST to other Time Sharing 
Option (TSO) tasks is shown in this section, and the TEST system requirements 
are given. 


Using TEST and its Subcommands 


You can test a problem program using basic debugging functions supplied by the 
following TEST subcommands: 


The TEST Assignment function, which changes the contents of specified 
program locations in main storage or the contents of specific registers. 


AT, which interrupts the problem program at a specified location or locations 
so that you can issue subcommands to be executed at these locations. 


CALL, which initializes registers and begins execution of the problem program 
at an address that you specify. 


COPY, which transfers data from storage to storage, from register to register, 
from register to storage, and from storage to register. It also allows you to 
place storage addresses in a register. 


DELETE, which removes a specified module from main storage. 


DROP, which removes one or more symbols from the symbol table for the 
problem program. Only those symbols previously established with the 
EQUATE subcommand can be removed using DROP. 


END, which frees TEST storage when a terminal session is complete. 


EQUATE, which assigns a symbol to an absolute or symbolic address in the 
problem program or data area. You specify as subcommand operands the 
symbol and the address to which it is to be assigned. 


FREEMAIN, which frees a specified number of previously acquired bytes of 
main storage as if a FREEMAIN macro instruction had been issucd. 


GETMAIN, which acquires a specified number of bytes of main storage as if a 
GETMAIN macro instruction had been issued by the problem program. 


GO, which establishes parameters so that the machine module (IKJEGMNL) can 
either start or restart problem program execution at a particular address. If 
you specify an address, execution resumes at that address. If the problem 
program was interrupted by a breakpoint, execution resumes at the instruction 
following the breakpoint. 


LIST, which prints the contents of registers or of a main storage area either at 
a terminal or to a data set. 


LISTDCB, which prints the contents of a Data Control Block (DCB) either at a 
terminal or to a data set. 
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e LISTDEB, which prints the contents of the basic section and any direct access 
sections of a Data Extent Block (DEB) at a terminal or to a data set. You can 
receive the entire contents of those sections of the DEB or you can specify one 
or more fields within a DEB. 





¢ LISTMAP, which prints information about a problem program region at a 
terminal or to a data set. The information includes region size; problem 
program Task Control Block (TCB) address; names, lengths, and locations of 
all programs running under the problem program TCB; type and identification 
of all active request blocks; and the number, location and size of user 
subpools. 


¢ LISTPSW, which prints the contents of a Program Status Word (PSW) (eight 
bytes) at a terminal or to a data set. If you do not specify the address of the ° 
requested PSW, the LISTPSW subcommand retrieves the PSW from the most 
Request Block (RB) on your RB queue. 


¢ LISTTCB, which prints the contents of a TCB at a terminal or to a data set. 
You can receive the entire contents of a TCB or you can specify one or more 
fields within a TCB. 


¢ LOAD, which loads a module of the problem program. 


* OFF, which removes user breakpoints no longer needed and replaces them with 
the original problem program instructions. 


e QUALIFY, which allows you to specify the name of a program in main storage, 
and a Control Section (CSECT) within that program, or a TCB address from 
which relative addresses can be calculated. 


e RUN, which causes the problem program to be executed without interruption 
by any previously established breakpoints. RUN cause: the problem program 


to execute to completion from its beginning or from an address you specify. ) 
RUN then terminates TEST so that the TMP may dispatch your program as its we 
subtask. 


¢ WHERE, which prints at a terminal the absolute address of either a symbolic or 
relative address in the problem program, or the absolute address of either a 
load module or an entry point within a load module. 


Service Routines Used by TEST 


The TMP, TEST, and the problem program all use the same service routines to 

obtain TSO services. When a service routine has been invoked, it also resides in 

the user’s region until the routine has completed execution, unless your 

installation has placed that routine in the time sharing link pack area. ‘ 


The following service routines reside on SYSI.LINKLIB: PUTLINEF, GETLINE, 
PUTGET, STACK (module IKJPTGT), PARSE (module IKJPARS), and Command 
Scan (module IKJSCAN). 


The following service routines reside on SYSI.CMDLIB: Default Service Routine 
(module IKJEHDEF, alias IKJDFLT), and Dynamic Allocation Interface Routine 
(module IKJEFDOO, alias IKJDAIR). The service routines are described in detail in 
OS/VS2 TSO Terminal Monitor Program and Service Routines Logic , 
SY28-0650. 


Two TEST load modules are SVC routines and reside in virtual memory. When an 
SVC 97 instruction is issued, the OS/VS2 Supervisor fetches 1GC0009G; when an 
SVC 61 instruction is issued, the Supervisor fetches 1GC0006A. Each SVC routine is 





purged by the Supervisor when the routine exits. 
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Invoking TEST 


TEST can be invoked when you want to test your command processor or problem 
program that is not currently executing, when you want to test an executing 
program that is abnormally terminating, or when you want to test your command 
processor or problem program before it has finished executing. 


1. When you want to test your command processor or problem program that is 
not being currently executed, the TMP issues a READY message to request the 
next command. You respond with the command “TEST xxxx”’ (where xxxx is 
the name of your problem program). 


2. When you want to test a program that is currently being executed and which 
has begun to abnormally terminate, you receive a diagnostic message from the 
TMP followed by a READY message. The TMP is in effect asking, ‘“‘Do you 
want to terminate your program or test it?’ If you respond with a null line (a 
carrier return), the TMP returns control to the supervisor’s ABEND routine to 
abnormally terminate your program. If, however, you issue the TEST command 
with no operands, the TMP does not detach your currently executing command 
processor or problem program. Instead, it invokes TEST to debug the defective 
program. Since the problem program is already in memory, there is no need to 
fetch it. 


3. When you change your mind before your command processor or problem 
program completes and you press the attention key, the TMP receives control 
after the time sharing control program processes the attention interruption. It 
then queries you by issuing its usual READY message. You respond by 
entering TEST, with or without the program name. If you omit the program 
name, the TMP assumes that you want to test your currently executing 
problem program or command processor as in the second situation. If, 
however, you enter a program name as a TEST command operand, the TMP 
assumes that you have changed your mind and want to test a program other 
than the one currently executing. The TMP detaches the currently executing 
program task and invokes TEST. TEST loads the problem program you want to 
debug as in the first situation. (If you enter the same program name as the 
one that was running, you will lose the copy of the program currently in 
memory, and TEST will fetch a new copy.) 


When the TMP issues a LINK macro instruction to invoke TEST, the TEST 
initialization module (IKJEGINT) is fetched from SYS1.CMDLIB by Contents 
Supervision. IKJEGINT contains its own abnormal termination routines and the 
1/O module, [KJEGIO. IKJEGINT attaches the TEST load module (IKJEGLDR), if 
the problem program is not already a subtask of the TMP. If IKJEGLDR is 
attached, it fetches the problem program, then purges itself by issuing an XCTL 
macro instruction to the problem program's entry point. 


The problem program is fetched in one of two ways: 


e The TMP causes the program to be fetched by attaching the program directly 
or by attaching the program’s invoker. An example of the latter is the 
attaching of the RUN command processor, which then attaches the problem 
program. In either case, the terminal user has not issued the TEST command. 


e IKJEGINT attaches IKJEGLDR, which then directs the fetching of the problem 
program. The actual fetching is done by either Contents Supervision (through 
the program fetch routine) or the VS2 load module. The choice depends on 
the keyword, LOAD or OBJ, that the user specifies in the TEST command. 
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Relationship of TEST to Other TSO Tasks 


VS 2 
Contro] 
Program 


ATTACH 





One per System 


Time Sharing 
Contro| 
Task 





ATTACH 
One per User Region 


Region 
Control 
Task 





ATTACH Non-Paged Tasks (Reside in T.S, Control Region) 


—e———— mm ree ee 


SYS1.PROCLIB Paged Tasks (Reside in User's Region) 












LOGON / 
LOGOFF 7 
Scheduler 
XCTL 
y a LOGON JCL Procedures 
4 
San . TEST and TMP are a subtask of LOGON/LOGOFF. They run 
Reaaine Nigmben Reader / under the same TCB and return control to LOGON/LOGOFF 
Interpreter when: 
Terminal user issues LOGOFF command. 
XCTL Operator issues a MODIFY TS or a STOP TS command. 
TEST/TMP abnormally terminates and cannot recover. 
User presses OFF switch on terminal. 
Initiator 
ATTACH F 
Terminal . 
Monitor SYST.CMDLIB or 
Program Private Library 
LINK ATTACH 






Che Legend: 
== Data flow 





Service 
Routines 











> Contro! flow 


ES 
as Processor or sade He : F 
Processor . Problem ata reference 
(if not already Prognin 





Command 

















a subtask of 
Terminal Monitor Program ) 





Figure 1. Relationship of TEST to other TSO Tasks 
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Figure 1 illustrates the following points: 


The TMP is attached by an initiator after a reader/interpreter has read the 
LOGON procedure statements. 


Both TEST and the TMP are indirectly a subtask of LOGON/LOGOFF. Both 
programs return control to LOGOFF when the terminal user enters a LOGOFF 
command, the operator issues a MODIFY TS or STOP TS command, the 
TEST/TMP task abnormally terminates and cannot recover, or the terminal 
user presses the OFF switch on his terminal. 


TEST operates as part of the same task as the TMP; that is, both programs run 
under the same TCB. 


Either the TMP or TEST can attach a command processor or a problem 
program. The command processor or problem program then becomes a 
subtask of the TEST/TMP task. 


LOGON/LOGOFF, the TMP, TEST, and the command processor or problem 
program all normally reside in the user’s time sharing region. An installation 
can, however, place LOGON/LOGOFF and the TMP in the time sharing 
link-pack area. 


TEST System Requirements 


TEST occupies approximately 90K bytes as it resides on SYSI.CMDLIB. 
IKJEGMNL occupies approximately 21K bytes. IKJEGMNL remains resident after 
once being fetched and contains the following: 


Attention Exit routine, IKJEGATN. 

STAE Exit routine, IKJEGSTA. 

A copy of the 1/O module, IKJEGIO. 

Convert module, IKJEGCVT. 

The TEST subcommand name table, IKJEGSCD. 
The user subcommand name table, IKJEGSCU. 


The break element removal routine, IKJEGSRH. 
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Figure 2 gives the bytes of memory each TEST subcommand occupies. Four 
subcommands (Assignment, AT, END, and LIST) require the first subcommand 

load module to fetch and transfer control to a second load module, which then 

purges the invoking module. J 


Bytes of 
Subcommand Memory Occupied 


Assignment 
AT 


CALL 

COPY 

DELETE 

DROP 

END 

EQUATE See DROP 

FREEMAIN See LOAD 

GETMAIN See LOAD 
2,654 
7,912 

LISTDCB 3,800 

LISTDEB 3,968 

LISTMAP 2,044 

LISTPSW 2,000 

LISTTCB 6,154 

LOAD 4,964 

OFF 2,832 

QUALIFY 3,340 

RUN See GO 

WHERE 3,088 





Figure 2. Memory Occupied by TEST Subcommands 
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Section 2: Method of Operation 


This section describes TEST logic. It emphasizes functional descriptions of the 
TEST processor through method-of-operation diagrams and text, in some cases. 


The Method-of-Operation diagrams in this section are designed to give you an 
overall understanding of the TEST command processor, its functions, and its 
subcommands. There are three levels of diagrams; each level directs you to the 
next lower level of diagrams for greater detail. Using these diagrams and the 
visual table of contents, you can quickly reach the level of detail you need at an 
particular time. 


Level 1 The TEST Overview shows the major steps in the processing 
sequence of TSO TEST. 


Level 2. The functional overviews, Diagrams 1, 2, and 3, divide the 
processing sequence into three functional areas: initializing TEST, 
processing under TEST control, and processing under problem 
program control. Initializing TEST establishes the TEST 
environment; the processing functions control the TEST 
environment that initialization established. 


Level 3. The functional breakdowns, Diagrams 1.1 - 1.8 and 2.1 - 2.32 
show in greater detail the functions described in the first two 
functional overviews. For greater detail of processing under 
problem program control, you are directed to-specific diagrams in 
the first two functional areas. 


These diagrams, at the end of this section, are graphically broken into three 
areas: input, processing, and output. An expanded description explaining each 
processing step is provided for each diagram. These descriptions also become 
more detailed at each succeeding level. 


Arrows and other symbols are used to direct you through the diagrams. 
=> Heavy black arrow indicates diagram entry point. 
> White arrow indicates data movement. 


—Z 7 ZL Hatched arrow indicates data alteration. 
es Black arrow indicates control flow. 


——————w = Thin black arrow indicates a pointer. 


Off-page connector leads to a related diagram. 


EST Initialization Function 


The initialization function has three main parts: establishing the TEST 
environment, preparing a problem program for TEST, and inserting breakpoints. 
Method-of-Operation Diagram 1 is the initialization overview. Figure 3 is a 
summary of the initialization function. : 
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[TEST initiaization =| initialization IKJEGINT ae 


Loading the problem program IKJEGLDR 1.1, 1 ae | 


IKJEGAT 
IKJEGATD 
1GO009G 
IKJEGMNL 
IKJEGOFF 
IKJEGSRH 






















Breakpoint processing 


Figure 3. Initialization Function Summary 


Establishing the TEST Environment 


To establish the TEST environment, IKJEGINT performs the following tasks: 
e Obtains storage for TEST tables and work areas. 
e Initializes the tables. 


e Assumes control of the problem program if the program is in the process of 
being abnormally terminated or if the terminal user has interrupted its 
processing with an attention interruption. 


e Attaches IKJEGLDR to fetch either the problem program or the OS/VS load 
module, depending upon the presence of either the LOAD or OB) keyword 
operand on the TEST command (LOAD is the default option). 


e Issues an XCTL macro instruction to purge module IKJEGINT and fetch and 
transfer control to IKJEGMNL. ) 


Preparing a Problem Program for TEST 


Inserting Breakpoints 


Pseudo Breakpoints 
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If the problem program is not already a subtask of TEST when TEST is entered, it 
is brought into main storage by IKJEGLDR, which is attached by IKJEGINT, which 
attaches IKJEGLDR. 


IKJEGLDR fetches the problem program in either of two ways. If the problem 
program has been link-edited, IKJEGLDR issues an XCTL macro instruction for 
Contents Supervision to fetch the specified load module and transfer control to 

it. The second way IKJEGLDR fetches the problem program is to invoke the 

OS/VS load module to load the specified object module and then issue an XCTL 
macro instruction to transfer control to the loaded problem program. Loading a 
problem program is shown in Diagram |.1 and Diagram 1.2. - 


When a problem program is fetched, data set information about that program is 
saved by 1GCO006A, whose main function is to store in an SVC information block 
certain information regarding the data set on which a fetched problem program 
resides. This information is needed to resolve symbolic addresses. Diagram 1.3 
illustrates the main function of IGCOO06A. 


A breakpoint is an SVC 97 instruction that causes a planned transfer of control 
from the problem program to TEST, which allows TEST to control the problem 
program. A breakpoint can be one of two types: pseudo or user. Two types of 
breakpoints are inserted: pseudo breakpoints or user breakpoints. 





2 


A pseudo breakpoint is inserted by a TEST module so the module can route 
control to either IKJEGMNL or IKJEGINT. The SVC 97 instruction is placed in the 
Test Communication Table (TCOMTAB) rather than in the problem program, and 
the problem program’s restart address points to the SVC 97 instruction. Diagram 
1.4 and Diagram 1.5 describe pseudo breakpoints. Figure 4 describes the 


conditions for which pseudo breakpoints are inserted and indicates which TEST 
module inserts the breakpoint. 







TEST Module 


IKJEGAT 
IKJEGLDR 


Condition 


To process a new subcommand. 























When the problem program has been loaded by the OS/VS loader. 




















When a load module of the problem program is to be invoked by IKJEGINT 

the TEST load module. _ 7 

When a aibtade of TMP begins to terminate abnormally. 7 T IKJEGINT 
When a subtask of TMP is interrupted by an attention interruption. | IKJEGINT 
When an ABEND occurs during the execution of the problem . IKJEGMNL 


program or of the HELP command processor. 








When the user enters or simulates an attention interruption during | IKJEGATN 











the TEST session. 7 
To force a task switch. 7 7 IKJEGLDF 





To detect the completion of the problem program. IKJEGINT 





To force qualification of TCB at source level. IKJEGOQFY 





Figure 4. Conditions Requiring a Pseudo Breakpoint 


User Breakpoints 


A user breakpoint is inserted in the problem program by the AT subcommand 
processor, IKJEGAT, when the user enters an AT subcommand. An immediate 
user breakpoint is one requested without the DEFER keyword. IKJEGAT inserts 
the SVC 97 instructions at specified locations in the problem program and saves 
or chains the breakpoint information in a break element it builds: See “Section 
5: Data Areas” for the format and contents of a break element BRKELEM. 


A deferred user breakpoint is one requested by an AT subcommand that contains 
the DEFER keyword. IKJEGAT does not place any SVC 97 instructions in the 
specified module for deferred user breakpoints, because the module is not yet in 
the user’s region. IKJEGAT merely saves the information that describes the 
breakpoints in a defer element queue it builds. Later, when the specified module 
is available, IKJEGMNL uses IKJEGAT to activate the deferred breakpoint. User 
breakpoints are described in Diagrams 1.6, 1.7, and 1.8. 


Processing Controlled by TEST 


Once the TEST environment has been established, subcommands specified by the 
user are processed. (A subcommand summary is included in this section.) In 
processing subcommands TEST performs internal and exceptional operations 
discussed in this section. Subcommand processing continues until the user enters 
a GO, CALL, RUN, or ENID subcommand. When one of these four subeommands 
is entered, TEST either turns control over to the problem program or terminates 
the TEST session. The overview of processing controlled by TEST is described in 
Diagram 2. 


Subcommand Processing 


IKJEGMNL receives the subcommand the user entered and links to the associated 
subcommand processor when one of the following occurs: 


e A breakpoint is reached in the problem program. 1GC0009G issues a POST 
macro instruction to return control to IKJEGMNL. 


e An attention request interrupts a TEST module. 


e An ABEND in the problem program is intercepted by the TMP STAI Exit. 
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e Another subcommand processor executes a code of 0. 


e An ABEND in a subcommand processor is intercepted by the TEST STAE Exit 
Routine. 


Subcommand processing that is similar for all subcommands is described in ) 
Diagram 2.1. Specific subcommand processing is shown in Diagrams 2.2 through 
2.23 and is summarized in Figure 5. 


i : Diagram 
Assigning value(s) to one or more IKJEGPCH 
locations IKJEGASN 
Specifying a point of interruption IKJEGAT 23 
(breakpoint) in the problem program IKJEGATD 
Specifying a restart address and a IKJEGCAL entry 
parameter list point in IKJEGGO 


Moving data fields or addresses IKJEGCPY 


IKJEGDEL entry 
point in 
IKJEGLDF 
IKJEGDRP entry 
point in 
IKJEGEQU 


Ending the test session IKJEGEND 28 
IKJEGOFF " 
Placing a name and its absolute address |IKJEGEQU oe 
2.9 


and attributes in the symbol table in 
memory 
IKJEGFRE entry 
point in 


IKJEGLDF 


IKJEGGET entry 
point in 
IKJEGLDF 


IKJEGGO entry 
point in IKJEGGO 
Displaying one or more locations or IKJEGLST 
registers IKJEGLSA 
Displaying a DCB IKJEGDCB 
Displaying a DEB IKJEGDEB | 2B 
Displaying an map of storage assigned to ||KJEGMAP 

the problem program 


Displaying a PSW a ; IKJEGPSW 

IKJEGTCB 
IKJEGLOD entry 
point in 


. IKJEGLDF 
Removing a breakpoint from the problem 


IKJEGOFF 
program 
Specifying the QUALIFY load module or |IKJEGQFY 221 
entry name 
Specifying the restart address and the end |IKJEGRUN entry 222 
of the test session point in IKJEGGO 


Determining the current load module, IKJEGWHR pa 
2.23 














Removing a module from main storage 






















Removing one or more names from the 
symbol table in memory 






















Freeing an area of memory 













Allocating an area of memory 













Specifying the restart address 





















Displaying a TCB 


Loading a module 
























entry name and offset, or the current 
absolute address 


Figure 5. Summary of TEST Subcommands 





Internal TEST Operations 


Once a subcommand has been processed, a return code is issued to IKJEGMNL. 
Figure 6 lists these return codes, their meaning, and the action taken by 
IKJEGMNL. 







Normal return from all subcommand processors, except GO, RUN, QUALIFY 
and the IKJEGLDF module. Processes another subcommand, unless the 

previously processed subcommand is RUN or END. END causes a return to 
the TMP. RUN causes a transfer of control to the problem program. 


























and from the IKJEGLDF module. This return code is also set when the AT 
subcommand processor activates a deferred breakpoint. Branches to location 
IKJEGCTL in IKJEGMNL to restart the SVC 97 routine or the SVC 61 
routine. When the SVC 97 routine is restarted, the problem program is 
restarted. 


Normal return from the RUN subcommand processor. This return code is 
also set when a critical error occurs in RUN processing. Branches to location 
RUNRTURN to remove all breakpoints, clean up TEST, post the subtask 
ECB, and return to the TMP. In this case, the problem program is not 
detached by the TMP. It will be restarted by the OS/VS Dispatcher and will 








run to completion after IKJEGMNL has returned to the TMP. If a critical 
error has occurred in RUN processing, normal END processing occurs and 
the problem program does not get dispatched. 





Return from a subcommand processor that has been interrupted by an 
attention interruption from the terminal. IKJEGMNL branches to location 
SCREQ to process the new subcommand entered in response to the 
attention interruption. IKJEGMNL doesn't free the previously used input 
buffer, since the attention exit routine has already done so. IKJEGMNL gets 
the subcommand from the buffer pointed to by the IEBUF field of 
TCOMTAB. 


Return from the retry routine of a subcommand processor that has prevented 
an ABEND. IKJEGMNL branches to location SCREQ1 to get a new 
subcommand. If END processing has started, IKJEGMNL finishes the 
termination processing. 






Figure 6. Codes Returned to IKJEGMNL After Subcommand Processing 


TEST performs certain internal operations during processing. Three of these 
operations are discussed in this section: 


e Converting character codes. 


e Translating symbolic addresses, determining CSECT names, and resolving entry 
names. 


e Communicating with the terminal and creating the print data set. 


Figure 7 lists the internal operations, names the modules involved with each 
operation, and gives the diagram number that describes the operation. 


‘ Diagram 


Converting character codes IKJEGCVT png | 
Translating symbolic addresses, IKJEGSYM 
determining CSECT names, and resolving 2.25 
entry names 
Communicating with the terminal and IKJEGIO 226 
creating a print data set 
Invoking the HELP command IKJEGCIV 2.27 
Altering fields of the problem program's |IGCO0Q09G 2.28 
TCB or RB 
Searching for and removing specified IKJEGSRH 2.29 
breakpoints from the active queue 


















Figure 7. Internal TEST Operations 
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Converting Character Codes 


Certain TEST subcommand processors receive input addresses which they must 
convert to binary before they can process the addresses. Similarly, various 

subcommand processors must convert values to printable form in order to list the 2 
values in a message to the terminal or to include the values on the print data set. 

To convert addresses and values to binary or printable form, the subcommand 

processors invoke the convert module, IKJEGCVT. Diagram 2.24 describes 

IKJEGCVT. 





IKJEGCVT is invoked both directly and indirectly by subcommand processors. It 

is invoked directly to convert one or more values to binary or printable form. It 

is invoked indirectly, through a validity check exit routine from IKJPARS, to 

convert One or more addresses to binary. Figure 8 shows the subcommand : 
processors that invoke IKJEGCVT. 


Subcommand Module Invokes Invokes , 
Processor Name Directly Indirectly 
Assignment _IKJ EGPCH Xx 


eqeiele Een 
CALL IKJEGGO 


x 
x 

IKJEGEQU a 
| Go| wecco | TX 
x 

~. 
x 






























LIST IKJEGLST 
~ustocs | iKJeGocB 

IKJEGDEB 

IKJEGPSW 
IKJEGTCB 
IKJEGOFF 
_ IKJEGQFY 
IKJEGGO 
IKJEGWHR 












LISTDEB 
LISTPSW 
LISTTCB 
































QUALIFY _ 











x x! x x 


Figure 8. Subcommand Processors That Invoke IKJEGCVT 


Address Conversion: The processing for address conversions depends on the type 
of address being converted and whether the conversion is to binary or to 
printable form. Figure 9 lists the input parameters and the processing for each 
type of address. routine belonging to a subcommand processor. After processing, 
control is returned to the balidity check exit routine. The output of the 
conversion to binary form is located in the PSEUSER field of the PDE. The 
output of the conversion to printable form is located in a 32-byte work area 
pointed to by the CONAREA field of TCOMTAB. : 
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Part 2: Printable Form 


Input Parameters Processing 


If floating 
Type of 
Address | Register 0 | Register 1 
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specified, 
Negative = 
Convert to 


Printable 
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exit 
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Figure 9. (Part 2 of 2) Address Conversion To Binary and Printable Form 


Value Conversion: The processing for value conversion depends on the type of 

value being converted and whether the conversion is to or from binary form. 

Figure 10 lists the input parameters and the processing for each type of value. 
IKJEGCVT performs the processing and receives control from a subcommand 
processor. After processing control is returned to the caller. The output of the : 
conversion is located in a 32-byte work area pointed to by the CONAREA field op 
TCOMTAB. The length of the output is identified in the first byte. 
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Conversion | Register 0 


From Binary 
to 
Hexadecimal 


From Binary 
to 
Instruction 


From Binary 
1 to 
FixedPoint 
Decimal 


From Binary 


Input Parameters 


Negative = 
Convert to 
Printable 


Negative = 
Convert to 
Printable 


Negative = 
Convert to 
Printable 


Negative = 
Convert to 


Processing 


Hex code 
Register 1 


Positive = 
convert a 
value 

Points to a 
Value PDE 


Points to a 
Value PDE 


Points to a 
Value PDE 


Points to a 
Value PDE 


to Floating 
Point 
Decimal 


Printable 





Points to a 
Value PDE 


From Binary |Negative = 
to Convert to 
Constants: | Printable 
A, Y,S,V 


Negative = |Points to a 
Convert to |Value PDE 
Printable 
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to Packed 
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Figure 10. (Part 2 of 2) Value Conversion From Binary Form and To Binary Form 


Translating Symbolic Addresses, Determining CSECT Names, and Resolving Entry 
Names 


The symbol module (IKJEGSYM) translates an internal symbol, a module offset, 
Or an entry name into an absolute main storage address or a CSECT name 
depending upon the request from the calling module. The symbol, offset, or 
entry name, which pertains to the program being tested. are specified in the 
QUALIFY Or WHERE subcommand or in any subcommand that uses the convert 
module (IKJEGCVT). The Qualify, Where, or Convert module invokes IKJEGSYM 
to translate the input cxpression. 


A module offset or an entry name can be obtained for both a load module 

fetched by Contents Supervision and an object module that has been loaded by 

the VS2 load module. An internal symbol, however, can be resolved only for a : 
load module, because the OS/VS load module does not retain Assembler 

language symbol records. Internal symbols are therefore unavailable to 

IKJEGSYM, with the exception of a symbol the EQUATE subcommand places in 

TEST’s symbol table residing in storage. 


For each type of input, IKJEGSYM produces the output for the load module and 
the object module, subject to certain restrictions, as shown in Figure 11. 


Symbol resolution is possible for a load module only if the TEST parameter was 
specified during both assembly and linkage editing. Otherwise, IKJEGSYM cannot 
resolve symbols created during the assembly of a load module. The user can 
circumvent this limitation by using the EQUATE subcommand during the TEST 
session to equate specified symbols with their relative offsets within the module. 
The equated symbols are placed in a symbol table in main storage. The symbol 
table remains for the remainder of the TEST session, and symbols in the table are 
available to IKJIEGSYM. 
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Availability of Output Restrictions 


IGCOOO6A must have been invoked 
the symbol is in the when the load module was fetched, 
address of symbol table built in and must have been able to determine 
symbol memory by the EQUATE and save the DDname by which the 
subcommand. module was fetched, or have been able 
to identify the fetched data set as 
SYS1.LINKLIB. 


Offset |CSECT in Load module See “Internal Symbol’ 


in which offset 


module: ilies Object module The OS/VS load module must have 


had sufficient storage to build CESD 
entries 





Absolute main |Load module See ‘Offset in Module”’ 
storage 

address for 
entry name 


Object module 





Figure 11. Summary of the Input, Output, and Restrictions of Symbol Processing 


If IKJEGSYM cannot resolve an input request by use of the symbol table, it tries 
to read SYM or CESD records from auxiliary storage (for a load module), or the 
CESD entries in main storage (for an object module). 


If they: are needed for a load module, the SYM records or the CESD records are 
read from the partitioned data set (PDS) from which the module was fetched. To 
read and use these records, IKJEGSYM needs the following information: 


e The loaded address of the module. 
e The DDname of the data set. 
e The relative track and record address (TTR) of the PDS member. 


IKJEGSYM obtains the foregoing information from an SVC information block 
(SIB) which is built by IGC0006A. IGC0006A is invoked by Contents Supervision 
when a load module has been fetched, unless the load module is a system module 
that is protected by the zero protection key IGCO006A. IGCOO006A is invoked to 
build an SIB if either of the following took place: 


e The fetched module was link-edited with the TEST attribute. 


¢ The module was brought into main storage under a TCB that is a subtask of 
TSO. 


This means that the module could have been fetched by the TEST load module 
(IKJEGLDR) or by the LOAD subcommand processor (IKJEGLDF). Contents 
Supervision tests the TCBTCP bit in the TCBABF field of the requestor’s TCB; if 
the bit is ‘on’, the TCB represents a subtask of TEST. 


If 1GCO006A was not invoked for the module in question, IKJEGSYM cannot 
determine the DDname of the data set from which the load module was fetched. 
It cannot allocate the data set, and therefore it cannot read SYM or CESD records 
nor can it resolve the input symbol, offset, or entry name. In this case, 
IKJEGSYM assumes that the module is an object module, and it searches the 
entries in the contents directory and their associated extent lists, looking in main 
storage for a CESD entry for the module. 


Refer to Diagram 2.25 and Figure 12 for more information about translating 
symbolic addresses, determining CSECT names, and obtaining entry point 
addresses. 


Section 2: Method of Operation 33 










Type of Request 


1. Symbol: its 
address and 
attributes. 


Note: This request 
is possible only for 
a load module. The 
OS/VS Loader, 
when loading an 
object module, 
does not retain 
Assembler 
language symbol 
records. Therefore, 
the TEST Symbol 
module cannot 
obtain information 
about an object 
module’s internal 
symbols. 


(The exceptions are 
internal symbols 
the user has placed 
in a in-core symbol 
table in main 
storage via the 
EQUATE 
subcommand.) 






PDE 



























in combination with 
load name, and/or 
CSECT name. Thus, 
any of the following 
can be input: 


symbol 

or 

csect name symbol 
or 

loadname csectname 
symbol 


Loadname, if present, 
is pointed to by the 
load name pointer 
(PDELDNAM) in the 
PDE. 


CSECT name, if 
present, is pointed to 
by the entry name 


















A flag (PDEFLG2) 
indicates which is 
present. 


Symbol is pointed to 
by the address string 
pointer (PDEADRPT). 
(A flag in the 
PDEFLG4 field 
indicates whether the 
symbol or an address 
string is pointed to.) 










Input Parameters in 


Symbol either alone or 


pointer (PDECTNAM). 


Search 
Argument 












a. If the symbol is 
not fully qualified, the 
program searches the 
symbol table built in 
main storage by the 
EQUATE subcommand 
for the symbol name. If 
the symbol is fully 
qualified, the program 
performs the processing 
in step c. 


Issuing a type C 
find macro and 
specifying a TTR. 


Processing 

























. If the symbol is 
found, the program 
builds a symbol 
information block to 
contain the symbol 
information. 


. If the symbol is 
not in the core symbol 
table, or if it is fully 
qualified, the program 
determines the search 
argument and prepares 
to read symbol records 
from the member of the 

PDS from wilch the 

module was loaded. 












Nearest 
Listing 
Symbol 











Location of Output 



























Main storage 
address of symbol. |/block (SIB) pointed 


work in the PDE. 
(The PDRESYM flag 
[X ‘80°] in the PDE 
is set to indicate 
that the PDEUSER 
field Points to a 
SIB.) 


¢ Multiplicity factor. 
« Length of symbol. 
















FOUNDSYM 
BUILDSIB 


















GETINFO 

































Preparations consist of: 


« Getting a DDname 


and a TTR from the 
SVC information 
block. 


¢ Opening a DCB and 
specifying the 
DDname. 


FOUND1 






OPENDCB 


DOPOINT 


Figure 12. (Part 1 of 5) Translating Symbolic Addresses, Determining CSECT Names, and Obtaining Entry Point Addresses 
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Symbol information |SINCORES 


J 


Nearest 
Input Parameters in Search Listing 
Type of Request PDE Argument Processing Location of Output; Symbol 


ntinued 


d. The program reads 
symbol records from a 
member of the PDS, 
looking for the name of 
the CSECT in which the 
symbol is located. The 
program uses the 
CSECT name specified 
as the input parameter, 
or defaults to the 
currently qualified 
CSECT name stored in 
TCOMTAB. 


. When the Symbol 
module finds an entry in 
the symbol record that 
contains information 
about the specified 
symbol, it builds a 
symbol information 
block and places the 
symbol information into 
it. 


FOUNDSYM 


Symbol information 
includes: 


Main storage 
address 
of symbol. 


Symbol type. 
Multiplicity factor. 


Length of symbol. 


. The program sets a 
pointer to the symbol 
information block in the 
PDEUSER field of the 
PDE, and sets a flag 
(PDRESYM) to indicate 
that the field points to a 
symbol information 
block instead of to an 
entry point address. 


BUILDSIB 





Figure 12. (Part 2 of 5) Translating Symbolic Addresses, Determining CSECT Names, and Obtaining Entry Point Addresses 
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Nearest 








Input Parameters in Search Listing 
Type of Request PDE Argument Processing Location of Output; Symbol 
2. CSECT Name Load name (pointed to | Load name |a. The program searches |CSECT name A work area, GETIF = 
(requested only |by the load name the SVC Information pointed to by the 
by IKJEGWHR) [pointer field blocks for the load PDE entry name 
(f th [PDELDNAM)). name. pointer 
emedule (PDECTNAM) 
has not been b. When an SVC FOUND! 
link-edited, refer information block is 
to number 4, found that contains the 
“Object load name, the program 
Module.” gets the following 
information from the 
block: 
e« Loaded address of 
the module. 


« DDname of the 
partitioned data set 5 
from which the 
module was 
fetched 





« Relative track and 
record address (TTR 
or the desired 
member of the 
partitioned 
data set. 


c. The program opens the OPENDCB 
DCB, specifying the 
DDname obtained from 
the SVC information 
block. 


d. The program issues a DOPOINT 
FIND macro (specifying 
the TTR) to position the > 
data set to the desired 
member. 


e. The program reads the FINDCESD 
CESD records from the 
member. 


f For each entry, the SEARCH4 
program computes the 
offset from the start of 
the member by adding 
the length of a CSECT 
to its relative address 
within the member. 
From the computation, 
the program finds the 
CSECT that contains 
the input offset. 


g. The program places the FENTRY 
found CSECT name in 
the work area belonging 
to IKJEGSYM and 
Points the PDE entry 
name pointer to the 
CSECT name in the 
work area. 





Figure 12. (Part 3 of 5) Translating Symbolic Addresses, Determining CSECT Names, and Obtaining Entry Point Addresses 
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Nearest 
Listing 
Symbol 


Search 
Argument 


Input Parameters in 


Type of Request PDE Processing Location of Output 


f 3. Load address 
-" ssociated with 
try name. 


PDEUSER field of 
the input PDE 


GETINFO 
FINDCESD 


Load name 
initially, then 
entry name 


a. Initial processing is 
the same as in steps 
a-e in ““CSECT Name.” 


. For each CESD 
record, the program 


Entry name: in entry 
name pointer field 
(PDECTNAM) 


Load name: pointed to 
by the load name 


Main Storage 
address associated 
with entry name. 


(If the module FINDNAME 


has not been 


link-edited, refer | pointer field, examines entry name 
to number 4, PDELDNAM (the first field in the 
Object entry). 

Module.”) If load name is 


missing, the symbol 
module uses as a 
default the currently 
qualified load name in 
the TCOMTAB (at 
TSTCURLD). 


. When the symbol 
module finds the 
specified entry name, it 
computes the entry 
point (loaded address) 
as follows: 


« Gets the offset from 
2 the CESD entry. 


Adds the offset to 
the loaded address 
of the module, 
obtained from the 
SVC information 
block. 


. The program places 
the main storage 
address in the 
PDEUSER field of the 
input PDE. 


FOFFSET 


CSECT name 


Main storage 
address associated 
with entry name 


4. Object module GETINFO 


NOSVCINF 


Load name (pointed to |Load name_ |The follcwing processing 
by the load name initially, then jis the same for both types 
pointer field, of request CSECT name of 
PDELDNAM) loaded address: 


Offset from start of 


A work area, 
pointed to by the 
PDE entry name 
pointer 
(PDECTNAM) 


Request for 
CSECT Name 


a. The program searches GETINFO 


¢ or 
2quest for 


waded address 
associated with 
entry name 


Note: Internal 
symbols can't be 
resolved, because 
the OS Loader 
doesn't retain 
symbol records 
created during 
assembly. 
However, the 
symbol module can 
resolve any internal 
symbols that the 
user has placed in 
the symbol table in 
main storage, via 
the EQUATE 
subcommand. 


Figure 12. (Part 4 of 5) Translating Symbolic Addresses, Determining CSECT Names, and Obtaining Entry Point Addresses 


bad module (pointed to 
by address-string 
pointer field, 
PDEADRPT) 


Entry name (pointed to 
by the entry name 
pointer field, 
PDECTNAM) 


Module name (may or 
may not be present - 
pointed to by the load 
name pointer field 
PDELDNAM) 


Note: If the module 
name is missing, the 
symbol module uses as 
a default the currently 
qualified load name in 
TCOMTAB (at 
TSTCURLD). 


SVC information blocks 


looking for a load name. 


This search will fail if 
the module is an object 
module. Since the 
module was not loaded 
by Contents 
Supervision, an SVC 
information block was 
not built. (If an SVC 
information block is 
found, the module must 
have been link-edited 
and is a load module.) 
The symbol module 
continues to search for 
the module as a load 
module. 


. When the symbol 


module doesn't find the 
specified or defaulted 
load name in the SVC 
information blocks, it 
searches the contents 
directory entries (CDEs), 
starting with the 
contents directory entry 
for the currently 
qualified load module. 
(This CDE is queued 
from the request block 
pointed to by the PPRB 
field in TCOMTAB.) The 
symbol module 
compares the load 
name in the CDE with 
the specified or 
defaulted load name. 


PDEUSER field of 
the PDE (see 
number 3) 


NOSVCINF 
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Nearest 
Listing 
Symbol 









Search 
Argument 


Input Parameters in 
PDE 




































Type of Request Processing Location of Output 





4. Continued c. If the symbol module 
locates the load name 
in the currently qualified 
CDE (step b) it 
examines the extent list 
associated with the 


CDE (see step d). 


If it does not find the 
load name in the 
currently qualified CDE, 
it searches for the load 
name in the CDE queue. 
(The queue origin is the 
TCBJPQ field in the 
TEST/TMP TCB.) If the 
load name is still not 
found, the symbol 
module issues an error 
message and returns 
control to the caller. 


CDECHAI 


NOTFOUND 











































. If the symbol module 
finds a contents 
directory entry (CDE) 
that contains the 
desired load name, it 
determines that the 
CDE is for an object 
module. It then 
examines the associated 
extent list to determine 
if CESD information for 
the module exists in 
main storage. 


Note: If the CDE is not 
found, the symbol module 
returns to the caller with 
an error code.) 





J 


e. The symbol module OSLOADER 
tests the second 
address entry in the 
extent list. If the 
second address entry is 
non-zero, the entry 
Points to a CESD 


record in main storage. 


f. The symbol module OBJMOD 
then obtains the needed 
information from the 
CESD record in main 
storage in a manner 
similar to that used for 
a CESD record in 
auxiliary storage. (See 
load module request 
types number 2 and 3.) 


g. Information is placed 

in either a work area or 
the PDEUSER field, as 
in load module request 
types 2 and 3. 


Figure 12. (Part 5 of 5) Translating Symbolic Addresses, Determining CSECT Names, and Obtaining Entry Point Addresses 
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Exceptional Operations 


Communicating with the Terminal and Creating the Print Data Set 


The 1/O module (IKJEGIO) handles 1/O requests from any TEST module. Such 
1/O is an internal function of the TEST program, that ts, the TEST program, 
rather than a terminal user, initiates the 1/0. 


The 1/O module handles three types of I/O requests: 


e GETLINE request, which is a request for input, either data or a subcommand. 
The data is obtained from the terminal; the subcommand is obtained from 
either the terminal or a subcommand list in main storage. (The list is built by 
the AT subcommand processor.) 


e PUTGET request, which is a request to solicit new input from either the 
terminal or from a subcommand list in main storage. (The subcommand list, if 
it exists, was built by the AT subcommand processor.) The PUTGET request 
causes the I/O module to issue a message and to obtain the required input. 


e PUTLINE request, which is a request to send either a line of data, or a message 
to the terminal or to a print data set. When specifying the PRINT keyword, 
the LIST, LISTTCB, LISTDEB, LISTDCB, LISTPSW, and LISTMAP subcommands 
request output to a print data set. 


Refer to Diagram 2.26 for more information about communicating with the 
terminal and creating the print data set. 


Exceptional operations in TEST consist of handling an attention request from the 
terminal and handling an abnormal termination in the TEST command processor. 
Figure 13 lists the modules involved in these operations and the diagrams that 
describe the operations. 


; ’ Diagram 





Handling an attention interruption from IKJEGATN 


the terminal 








Handling an abnormal termination in the |IKJEGSTA 
TEST program 





Figure 13. Exceptional TEST Operations 


Handling an Abnormal Condition in TEST 


There are two types of abnormal situations the TEST command processor can 
encounter: an error in the problem program and an error in the TES! command 
processor itself. 


An ABEND in the problem program is handled by the STAI Exit routine, 
IKJEFTO4, of the TMP. The STAI Exit routine places the user in TEST mode. (For 
a detailed description of the TMP STAI Exit routine, see the OS/VS2 Tso 
Terminal Monitor Program and Service Routines Logic.) 


An error in the TEST command processor itself is circumvented by the STAE Exit 
routine (IKJEGSTA) of TEST. This routine issues diagnostic messages and causes 
control to be passed first to an appropriate termination routine and then to 
IKJEGMNL to continue the test session. . 


Because of the similarity between STAI and STAE, remember that the STAI Exit 
routine handles a problem in the subtask (the problem program), where as the 
STAE Exit handles a problem in the parent task (the TEST command processor). 
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The STAE Exit routine’s main functions consist of: 


e Issuing a specific diagnostic message to the terminal for an abnormal condition 
that was predictable. 


e Issuing a general purpose diagnostic message to the terminal for an abnormal 2 
condition that was not predictable. 


e Requesting a ‘retry’ entry to a routine that frees a 104-byte STAE work area 
and resets certain switches. 


There is a separate retry routine for each module in TEST. All such routines, 

except the one in IKJEGMNL, return control to IKJEGMNL so it can ask for a new 
subcommand and continue the TEST session. (IKJEGMNL’s retry routine 

effectively executes an END subcommand by returning to the TMP.) . 


The processing of the STAE Exit routine in TEST is part of a sequence that 

begins in the first load module of the Supervisor’s error routine (IGCOOOIC), 

continues through the Supervisor’s ABEND/STAE Interface routines (IGCOBOIC - : 
IGCOEOIC), and ends with execution of one of a number of retry routines within 

TEST. The address of the retry routine to be used for an error is placed in 

location TSTRETR in TCOMTAB by each TEST module when it gets control. 

IKJEGMNL places the address of the STAE Exit routine in the TSTSTAE field of 

TCOMTAB. 


Refer to Diagram 2.31 for more information on handling an abnormal condition 
in TEST. (For detailed flowcharts of the ABEND/STAE Interface routines, see 
OS/VS2 Supervisor Logic .) 


Processing Controlled by the Problem Program 
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Diagram 3 illustrates processing controlled by the problem program. IKJEGMNL 
starts the problem program after a subcommand issues a return code of 4. 
IKJEGMNL then issues a POST macro instruction to return control to IGCO009G, 
which exits. This forces the transfer of control to the problem program, which 
executes until a terminating condition occurs. Terminating conditions are: 





¢« The problem program issues an ATTACH, LINK, LOAD, or XCTL macro 
instruction to another module. 


¢ The problem program reaches a breakpoint. 
e The problem program receives an attention interruption. 
¢ The problem program completes normally. 


e The problem program begins an abnormal termination, and unprocessed 
statements remain. 


e« The problem program terminates abnormally, and no unprocessed statements 
remain. IKJEGCVT performs the processing and receives control from the 
validity check exit 
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Section 3: Program Organization 


This section contains module descriptions arranged alphabetically by module 
entry-point name. They contain reference information, such as register usage, 
system routines called, return codes, etc. 


TEST uses the following 29 assembly modules, 11 macros, and 2 supervisor call 
routines. 


IKJEGASN BRKELEM IGCOOO6A—SVC 61 
IKJEGAT IKJEGDBE IGCOO09G—SVC 97 
IKJEGATD IKJEGDME 
IKJEGATN IKJEGS6A 
IKJEGCIV IKJEGS9G 
IKJEGCPY IKJEGSUB 
IKJEGCVT IKJEGSVB 
IKJEGDCB IKJEGSVOQ 
IKJEGDEB IKJPARMA 
IKJEGEND TCOMTAB 
IKJEGEQU 

IKJEGGO 

IKJEGINT 

IKJEGIO 

IKJEGLDF 

IKJEGLDR 

IKJEGLSA 

IKJEGLST 

IKJEGMAP 

IKJEGMNL 

IKJEGOFF 

IKJEGPCH 

IKJEGPSW 

IKJEGQFY 

IKJEGSRH 

IKJEGSTA 

IKJEGSYM 

IKJEGTCB 

IKJEGWHR 
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IGCOOO06GA-SVC 61 Routine 


Entry Information 


Input Parameters 


Function 


Data Areas 
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TSO Test 


Diagram 1.3 contains the method-of-operation information for this routine. 


J 


IGCOO06A is entered from Contents Supervision or the Overlay Supervisor when a 
module or overlay segment of the problem program is fetched. Entrance is from 
the SVC second-level interruption handler of the supervisor. 


Parameters received from Contents Supervision are: 

Reg 1 Complement of the address of the DCB used to fetch the module. 
Reg 3 ~=Adddress of the supervisor’s communication vector table (CVT). 
Reg 4 Address cf the current TCB. 

Reg 5 Address of the SVC 61 routine’s supervisor request block (SVRB). 
Reg 11 Address of the BLDL entry for the module in RBGRSAVE. 

Reg 12 Address of the extent list for the module in RBGRSAVE. 
Parameters received from the Overlay Supervisor are: 

Reg 1 = Zero. 

Reg 3. Address of the supervisor’s CVT. 

Reg 4 = Address of the current TCB. 

Reg 5 Address of SVC 61 routine’s SVRB. 


Reg 12 Address of the module’s segment table in RBGRSAVE. This is the same 
as the loaded address of the module contained in the extent list. | 


The SVC 61 routine performs one main function and one auxiliary function. Its 
main function is to store information in an SVC information block that describes 
the data set from which the module was fetched. This information (load name, 
loaded address, and DDname) is used later by IKJEGSYM, the TEST Symbol 
module, when it tries to resolve internal symbols or entry names specified for the 
fetched module. 


The routine’s auxiliary function is to temporarily post control to either IKJEGINT 


or IKJEGMNL, depending on which TEST module is active when the SVC 61 

routine is invoked. IKJEGINT, when posted, issues an XCTL macro instruction to 

fetch Mainline and give control to it. Mainline, when posted, links to the AT 

subcommand processor (if necessary) to activate deferred breakpoints that the 

user specified for the fetched module. Mainline then posts control back to the - 
SVC 61 routine. 


Created: The SVC information block is created by this module. 


Updated: The TSTTRN field of TCOMTAB is set to point to the first SVC 
information block if TEST is running. If TEST is not running, the TCBTRN field 
of the current TCB is set to point to the first SVC information block. 


Consulted: The following data areas are consulted by IGCOO06A: 





e The TCBTRN field of the TCB points to TCOMTAB if TEST is running. The 2 
TCBTIOT field of the TCB points to the task I/O table (TIOT). ~ 


e If the TIOT is available, it contains the DDname that was used to allocate the 
data set from which the module was fetched. 


C 


Routines Called 


e« An open DCB is used by Contents Supervision when it fetches the module, 
and by IKJEGSYM for symbol resolution. 


e The BLDL entry for the PDS member from which the module was fetched is 
consulted. 


e The extent list for the PDS member from which the module was fetched is 
consulted for pointers. 


e The SVRB for the SVC 61 routine is consulted to get work areas and pointers. 


TSO: No TSO routines are called by IGCO0Q06A. 

System: 1GC0006A calls the following system routines: 

e GETMAIN, to get space for an SVC information block and an ECB. 
e POST, to make the IKJEGMNL or IKJEGINT module dispatchable. 


e WAIT, to force control to IKJEGMNL or IKJEGINT by temporarily making the 
SVC 61 routine nondispatchable. 


Register Usage during Module Execution 


Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


Reg 0 Used as a parameter register. 

Reg 1 _—Used as a parameter register. 

Reg 2 _— Points to the DCB used to fetch the problem module. 
Reg 3 __—s Points to the supervisor’s CVT. 

Reg 4 __—s— Points to. the current TCB. 

Reg 5 __—~ Points to the SVRB of the SVC 61 routine. 

Reg 6 Used as a base register. 

Reg 9 ~=Points to TCOMTAB when TEST is running. 


Reg 10 Used as a base for the dummy section (DSECT) of the SVC information 
block. 


Reg 11 Points to the extended save area of the SVRB of the SVC 6! routine. 


Reg 12 Points to the segment table if the SVC 61 routine is invoked from the 
Overlay Supervisor. 


If the current task is running under TSO, exit is to the Contents Supervisor (or 
the Overlay Supervisor). 


If TEST is running, the origin of the chain of SVC information blocks is the 
TSTTRN field of TCOMTAB. If TEST is not running, the origin of the chain of 
SVC information blocks is the TCBTRN field of the current TCB. 


0 Successful completion. 


4 Error encountered. 


IGCO006A has no message CSECT. 
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IGCO0009G-SVC 97 Routine 


This module consists of two parts: a breakpoint handler whose entry point is 
1GC0009G and a subroutine or service routine of the TEST program, whose 
symbolic address is TSTSVCO1!. Diagrams 2.28 and 1.4 through 1.8 contain the 
method-of-operation information for this routine. 





Entry Information 


1GC0009G is entered from any module of the TEST program when used as a 
subroutine of TEST, or from any module of the problem program when used as a 
breakpoint handler. 


Input Parameters 


When IGC0009G is used as a breakpoint handler, the TCBTCP bit is ‘‘1”’ in the 
current TCB. 


When IGC0009G is used as a subroutine of TEST, the TCBTCP bit is ‘‘0’’, and - 
Register 1 points to a three-word parameter list. 


Function 


IGC0009G is invoked as a breakpoint handler in two cases. It is invoked when a 
user-inserted breakpoint (an SVC 97 instruction) is executed in the problem 
program, and it is invoked when a pseudo breakpoint is executed for a TEST 
module. 


The TEST module saves the problem program’s restart address in the TSTGO field 
in TCOMTAB, and either branches to an SVC 97 instruction or points the problem 
program’s RBOPSW to an SVC 97 instruction. The SVC 97 instruction is stored at 
one of the following locations: 


« TSTGO+6 in TCOMTAB, for most pseudo breakpoints. 





e« The problem program’s entry point, if the TEST load module brought the 
program into main storage. This SVC 97 instruction is set by IKJEGINT for a 
load module and is set by the TEST load module for an object module. 


e The PPEXIT field in TCOMTAB. IKJEGINT sets this breakpoint with a pointer 
to PPEXIT in Register 14 of the problem program. This action prepares for a 
pseudo breakpoint that will be taken when the problem program completes. 


When invoked from a user-inserted breakpoint, IGC0009G: 


1. Checks for an invalid caller. If the caller is invalid, the module exits; if the 
caller is valid, the module continues. 


2. Checks if the count in the corresponding break element is exhausted. If it is, - 
the module continues to Step 3; if it is not, the module branches to Step 4. 


3. Points the instruction counter in the problem program’s restart address 
(RBOPSW) to the SVC 97 instruction. Then it transfers control to IKJEGMNL 
and waits for IKJEGMNL to get and link to the subcommands desired by the 
terminal user. IKJEGMNL returns control to IGC0009G. 


4. Either points the problem program’s restart address (RBOPSW) to the saved 
program instruction in the break element or prepares for a simulated BAL or 
BALR instruction, depending on the type of instruction that was replaced by 
the breakpoint. If the routine cannot identify the breakpoint, it ignores the 
breakpoint and continues processing. 


5. Restarts the problem program by issuing an SVC 3 instruction and exiting. 





6. Sets the problem program’s restart address (RBOPSW) to the next instruction 
after the breakpoint and exits. The supervisor’s Exit routine and the VS2 
Dispatcher restart the program. The preceding action occurs when control is 
received from the SVC 97 instruction in the break element. 1GC0009G does not 
receive control if the executed instruction was a branch or an SVC instuction, 
or if it caused an ABEND. 
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C 


Data Areas 


Routines Called 


When invoked from a pseudo breakpoint, this routine: 


1. Checks for an invalid caller. If the caller is invalid, the routine exits; if the 
caller is valid, the routine continues. 


2. Restores the saved RB wait count of the problem module to be given control. 
The count was saved at TSTGO+4 in TCOMTAB. 


3. Checks the TSTSTAI bit in TCOMTAB to determine if the problem program 
terminated abnormally. If so, the routine frees the 104-byte STAE work area 
(if one exists), and restores the saved program registers. 


4. Passes control to either IKJEGMNL or IKJEGINT and waits for that TEST 
module to execute and perform a function needed by the module that set the 
pseudo breakpoint. For example, IKJEGMNL gets control from module 
IKJEGLDF via a pseudo breakpoint to restore the problem program’s registers 
in SVC 97’s SVRB. IKJEGLDF cannot restore the registers, because it operates 
under the subtask and therefore cannot invoke SVC 97 as a subroutine. 


When the SVC 97 routine receives control from IKJEGMNL, the routine resumes 
processing with the execution described in step 4 of the user-inserted breakpoint 
description, causing the problem program to resume execution. 


When it is necessary to modify protected main storage, the subcommand 
processors of TEST call IGCo009G. The functions performed include setting fields 
in the TCB and the RB as well as validity-checking addresses. 


Created: A queue of ECBs, chained from the TSTSVCQ field in TCOMTAB is used 
by IKJEGMNL to handle in first-in, first-out order concurrent POSTs from 
IGCoo009G during multitasking. 


Updated: As a breakpoint handler, IGC0009G updates the BRKCHAIN and 
BRKCOUNT fields of a break element, and the following fields in TCOMTAB: 
PPTCB, TSTMTASK, TSTSVCQ, ECBPP, and ECBTST. 


As a subroutine of TEST, 1GC0009G updates fields in the specified TCB or RB. 


Consulted: As a breakpoint handler, [GC0009G consults the break elemeni for the 
breakpoint that was encountered and the origin of the break element queue, 
location BREAKTAB in TCOMTAB. 


As a subroutine of TEST, IGC0009G does not consult any data areas. 


TSO: 1GC0009G calls no system routines. 

System: [GC0009G calls the following system routines: 

e FREEMAIN, to free main storage used as work areas. 

e GETMAIN, to obtain main storage for work areas. 

e POST, to indicate completion of initialization processing. 

e WAIT, to wait on event completion so that TEST processing can continue. 


e SVC 3, to terminate SVRB processing. 


Register Usage during Module Execution 


Reg 1 _— Points to the input parameter list if the SVC 97 routine is used as a 
subroutine of TEST. 


Reg 3 __—s— Points to the CVT. 
Reg 4 ___—s— Points to the current TCB. 
Reg 5 ‘Points to the SVRB for IGC0009G. 
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~—. 


Reg 7 Points to the break element queue. ~~ 
Reg 9 ~=Points to TCOMTAB. 
Reg 10 Used as a base register. J 
Reg 11 Used as a link register. | 
* Reg il2 Used as an internal return register. 


Reg 13. Used as a mask register for clearing high-order bytes. 


Exit Information 


When 1GC0009G acts as a breakpoint handler, it exits to the restart address of the 
‘problem program. 


When 1GC0009G acts as a subroutine of TEST, it exits to the calling TEST module. 


Output Parametérs 
1GC0009G has no output parameters. 


Return Codes 


Register 15 is unchanged with a successful return from use as a breakpoint 
handler. 


Q Successful return from use as a TEST subroutine, except when used as an 
address validity checker. 


Q Address is not write-protected from the user from use as an address validity 
checker. 


4 Address i& not read-protected from the user from use as an address validity 


checker. ) 
8 Address is inaccessible to the user from use as an address validity checker. 


Message CSECT 
IGC0009G has no message CSECT. 


¥ 


IKJEGASN-Assignment Function Processor, Second Load Module 


Diagram 2.2 contains the method-of-operation information for this module. 


Entry Information 
IKJEGASN is entered from IKJEGPCH via an XCTL macro instruction. 


Input Parameters 
IKJEGASN receives the input buffer contents, and Register 9 points to TCOMTAB. 


Function 


IKJEGASN is the second of two load modules that process the assignment 
function of TEST. The Assignment function changes values in main storage and 
in registers, according to the following user specifications. 


e C, which specifies character data. 
e X, which specifies hexadecimal data. 


¢ B, which specifies binary data. 





« H, which specifies fixed point binary (half-word) data. 
e F, which specifies fixed point binary (full-word) data. 


e E, which specifies floating point (single precision) data. 
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Data Areas 


Routines Called 


e D, which specifies floating point (double precision) data. 
e P, which specifies packed decimal data. 

e Z, which specifies zoned decimal data. 

e A, which specifies address constant data. 

e S, which specifies address (base plus displacement) data. 
e Y, which specifies address constant (half-word) data. 


IKJEGASN then converts the data to printable hexadecimal if necessary and 
formats it according to the specified type. IKJEGASN determines if the address 
specified for data modification is register type. If so, it causes a SVC 97 
instruction to be issued which moves the changed data to the register address. 


Created: IKJEGASN creates no data areas. 


Updated: IKJEGASN updates the ABENTAB1, TSTFLGS1, TSTFLGS2, and 
TSTRTYPT fields in TCOMTAB. 


Consulted: IKJEGASN consults BRKELEM, VALUPDE, TCB, TPL, CVT, the work 
area pointed to by TCOMTAB, and the following fields in TCOMTAB: CONAREAS, 
ECBLOG, ECBTMPA, OUTBUF, TSTFLGS1, PPTCB, REGSAVE2, REGSAVE3, 
TPUTADDR, TSTCONVT, TSTSTAE, and WORKAREA. 


TSO: IKJEGASN calls the following TSO routines: 
e IKJEGCVT, to convert values. 
e IKJEGIO, to issue error messages. 


¢ IKJEGSRH, to remove a break element and to see if the assignment will 
overlay any breakpoints. 


e« SVC 97, to modify the user’s general purpose or floating point registers. 
System: IKJEGASN calls the following system routines: 
e STAE, to establish an abnormal termination exit. 


e FREEMAIN, to free core used as work areas. 


Register Usage during Module Execution 


Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


Reg 9 _ ~=— Points to TCOMTAB. 
Reg 10 Points to PCHWORK, the work area. 


Reg 11 Used as a base register. 


IKJEGASN exits to IKJEGMNL. 


IKJEGASN has no output parameters. 


0 Normal end processing continues. 
16 Attention interruption encountered during processing. 


20. ~=STAE exit routine entered. 


IKJEGMSD is the message CSECT for IKJEGASN. 
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IKJEGAT-AT Subcommand Processor, First Load Module 





Diagram 2.3 contains the method-of-operation information for this module. 


Entry Information 
IKJEGAT is entered from IKJEGMNL via a LINK macro instruction. 


Input Parameters 
Register 9 points to TCOMTAB. 


To activate a deferred breakpoint, the first two words of the WORKSP work area 

contain the name of the module for which deferred breakpoints are to be 

activated. The TSTBUILD switch in TCOMTAB is set, to indicate that a new 

module is being fetched for the problem program. : 


To set an active breakpoint or store information about a deferred breakpoint, the 
input parameters of the subcommand are in the command buffer, whose address 
is the INBUF field of TCOMTAB. 





Function 

IKJEGAT has three functions: 

e It determines if an AT subcommand was issued for a DEFER request or if it 
was issued to activate breakpoints. If the request is to set a DEFER 
breakpoint, this module transfers control to the second load module, 

IKJEGATD, via an XCTL macro instruction. 

e It activates any deferred breakpoints that may have been specified for a newly 
fetched module. In this case, there is at least one element in the defer element ; 
queue. IKJEGAT is invoked by IKJEGMNL to build one or more break elements 
and set the corresponding breakpoints in the newly fetched module. 

e It builds break elements and inserts breakpoints at specified locations in the 
problem program. : 

Data Areas 


Created: IKJEGAT creates the BRKELEM, the subcommand chain save area, and 
the address string save area. 


Updated: IKJEGAT updates the PDEUSER and PDE2USER fields in the parameter 
description entry (PDE), and the following fields in TCOMTAB: ABFNTABI, 
TSTRETRY, TSTFLGS!I, TSTFLGS2, TSTFLGS4, and BREAKTAB. 


Consulted: IKJEGAT consults the DME, the DBE, the TCB, the CV1, the PDL, and 

the following fields in TCOMTAB: OUTBUF, CONAREA, WORKAREA, REGSAVE2, ‘ 
REGSAVE3, PARMLIST, INBUF, TPUTADDR, TSTCONVT, TSTADDR, TSTSTAE, 

TSTFLGS1, DEFERTAB, OPCODTAB, TSTOPCD2, and TSTSRHRT. 


Routines Called 
TSO: IKJEGAT calls the following TSO routines: 


e IKJPARS, to scan the subcommand and to check the syntax. Exit routines are 
used to check the validity of the IKJPARS parameters. 


e IKJEGCVT, to convert addresses and values. At entry to convert an address, 
Register 1 contains the complement of the PDE address, indicating an address 
conversion, and Register 0 is set to zero to indicate converstion to binary. 





e IKJEGIO, to issue error messages. At entry, Register 1 contains the 
complement of the pointer to the addresses of the length fields of the message. 
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IKJEGSRH, to build a BRKELEM for an address for which a BRKELEM already 
exists, that is, a duplicate breakpoint. The old BRKELEM is removed by 
IKJEGSRH before the new BRKELEM is built. At entry, Register 1 points to a 
three-word parameter list. The first and third words are zero; the second word 
is the address of the breakpoint. 


IKJEGBLD, to construct the input address string. The address string is built 
either in the address save area, if needed in building a break element, or in the 
output buffer, if an error message is to be written. At entry, Register 0 points 
to the PDE address from which the information to construct the address string 
will be obtained. Register 1 points to the area in which the string will be built. 
If the string is to be built for the break element, Register 1 must be negative 
to indicate a maximum of 100 bytes. Otherwise, a maximum of 26 bytes is 
constructed. 


System: IKJEGAT calls the following system routines: 


LINK, to invoke IKJPARS. 
XCTL, to transfer control to IKJEGATD. 
GETMAIN, to get space for a break element. 


FREEMAIN, to free the STAE work area, if it exists, and the current incomplete 
break element. 


STAE, to build a STAE control block for IKJEGSTA, the STAE exit routine for 
TEST. 


Register Usage during Module Execution 


Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


Reg Q Used as a parameter register. 


Reg 1 _—_ Used as a parameter register. 


Reg 3 ~=Reserved for maintenance. 


Reg 9 Points to TCOMTAB. 


Reg 10 Points to the common work area described by TSTCWORK. 


Reg 12 Used as a base register. 


IKJEGAT exits to IKJEGMNL via an SVC 3 instruction pointed to by Register 14. 
If IKJEGATD was entered for an AT DEFER subcommand, this module exits to 
IKJEGATD via an XCTL macro instruction. 


The output parameter for IKJEGAT is the BREAKTAB field in TCOMTAB, which 
points to the break element queue. 


16 


20 


Entered because of an AT subcommand. 


Entered to activate a deferred breakpoint for a newly fetched module of the 
problem program. 


The attention exit routine of TEST was entered to service an attention 
interruption from the terminal. 


The retry routine belonging to IKJEGAT was executed to handle a 
STAE-intercepted ABEND. 


IKJEGATM is the message CSECT for IKJEGAT. 


Section 3: Program Organization 14] 


IKJEGATD-AT Subcommand Processor, Second Load Module 


Diagram 2.3 contains the method-of-operation information for this module. 


Entry information 2 
IKJEGATD is entered from IKJEGAT (the first load module of the AT 
sybcommand processor) via an XCTL macro instruction whenever a deferred 
breakpoint is specified. 

Input Parameters 


Register 1 points to TCOMTAB. The PDEADDR field in the work area of 
IKJEGATD points to the first address PDE returned by IKJPARS. 


The TSTANSPL field in TCOMTAB points to a parameter descriptor list (PDL) that 
has been parsed and checks for validity by IKJEGAT. 
Function ” 


IKJEGATD first checks that all input addresses are fully qualified and that they 
specify the same load module name. 


The module then constructs a defer element queue in which it saves breakpoint 
information about a module that has not yet been fetched to memory. The defer 
element queue contains at least one defer module element, DME, and an 
associated defer break element, DBE. Each DME points to its DBE and contains 
the load name of the module for which breakpoint information is being saved. 
Each DBE contains a pointer to a parameter descriptor list built by IKJPARS, a 
pointer to the next DBE, and a pointer to an input buffer. The buffer contains 
the subcommand that specified the deferred breakpoint. 


Data Areas 
| 
Created: IKJEGATD creates the DME and the DBE. - 


Updated: IKJEGATD updates the DEFERTAB, TSTANSPL, TSTFLGS2, RETRY, and 
INBUF fields of TCOMTAB. 


Consulted: IKJEGATD consults the CVT, the TCB, the DME, the DBE, and the 
following fields in TCOMTAB: REGSAVE2, TSTANSPL, DEFERTAB, INBUF, 
JPUTADDR, and TSTSTAE. 


Routines Called 
TSO: IKJEGATD calls the following TSO routine: 
e IKJEGIO, to issue error messages. 
System: IKJEGATD calls the following system routines: 


e STAE, to build a STAE control block for IKJEGSTA, the STAE Exit routine for 
TEST. 


« GETMAIN, to get space for a defer module element and its associated defer 
break element. 


e FREEMAIN, to free the STAE work area, if it exists, using the retry routine 
(RETRY2). 


Register Usage during Module Execution 
Reg 1 —_ Used as a parameter register. 


Reg 3. ~——- Reserved for maintenance. 





Reg 9 Points to TCOMTAB. 
Reg 10 Points to common work area described by TSTCWORK. 
Reg 12 Used as a base register. 
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Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


IKJEGATD exits to IKJEGMNL via an SVC 3 instruction pointed to by Register 14. 


The DEFERTAB field in TCOMTAB points to the first defer module element in the 
defer element queue. 


0 Normal return. 
16 An attention interruption detected during module execution. 


20 The module’s retry routine, RETRY2, entered to handle a STAE-intercepted 
ABEND. 


IKJEGM2 is the message CSECT for IKJEGATD. 


IKJEGATN-Attention Exit Routine 


Entry Information 


Input Parameters 


Function 


Data Areas 


Diagram 2.30 contains the method-of-operation information for this module. 


IKJEGATN is entered from the Attention Handler of IKJVAROS, the region control 
task, via a LOAD PSW instruction. 


Register 1 contains the address of a parameter list, which consists of the 
following pointers: 


« A pointer to the Terminal Attention Interrupt Element (TAIE). 
e A pointer to an input buffer containing new input from the terminal. 


e A pointer to TCOMTAB. 


IKJEGATN performs the following functions: 


e It checks for no terminal input (length equals zero). A null line indicates that 
the user wants control to return to the point of interruption. 


e It invokes the PUTGET service routine to get a new input line and lo process a 
question mark for second level messages. 


e It posts control either to IKJEGMNL or to another interrupted TEST module. 


Eventually, control is passed to IKJEGMNL, which gets the newly entered 
subcommand and links to the appropriate subcommand processor. 


IKJEGBLD, a routine internal to IKJEGATN, builds an address string to a 
maximum of 100 bytes. As input, this subroutine requires a pointer in Register 0 
to the address parameter description element PDE and a pointer in Register 1 to 
the area in which the string is to be built. Upon return to the caller, Register 0 
contains the number of bytes constructed, and Register 1 contains a pointer to 
the byte following the last byte in the address string. If Register 1 is negative, 
the address string is built to only a maximum of 26 bytes. 


Created: IKJEGATN creates a new input buffer, queued from the INBUF field of 
TCOMTAB. 
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Updated; IKJEGATN updates the work areas described by the WORKSP dummy 
section, the {NBUF and TSTGO fields of TCOMTAB, and the high-order bit of the 
ECTSMSGF field in the environment control table FCT. 


Consulted: IKJEGATN consults the TAIE, the input buffer, TCOMTAB, and the | 
TPLCTCB field of the TEST parameter list. 





Routines Called 

TSO: IKJEGATN calls the following TSO routines: 

e PUTGET, fo issue messages to the terminal and gets terminal input. 

« The SVC 97 routine, to change the restart address of the problem program. 

» FELEARQ, to clear the input buffers. \ 

e STACK, to delete elements from the input stack. 

System: IKJEGATN calls the following system routines: 

e LINK, to provide linkage to the PUTGET service routine. 

» FREEMAIN, to free space for the buffer(s). 

¢ STATUS and POST, to make the subtasks dispatchable and nondispatchable. 
Register Usage during Module Execution 

Reg 8 ‘Points to work space. 

Reg 9 Points to TCOMTAB. 


Reg 12. Used as a base register. 


Exit Information 


IKJEGATN exits to the Supervisor Exit routine via an SVC 3 instruction pointed to ) 
by Register 14. 


Output Parameters 


The INBUF field in TCOMTAB points to the buffer containing the new 
subcommand. 


A post code of X*48’ is placed in the event control block ECB whose address is 
in the ECBTMPA field ‘of TCOMTAB. This code signifies that the TEST attention 
exit has been posted, rather than the attention exit routine of the TMP. 


Return Codes 
(0) Processing complete. 


Message CSECT 
IKJEGATM is the message CSECT for this module. 


IKJEGCIV—-HELP Command iInvoker 


Diagram 2.27. contains the method-of-operation information for this module. 


Entry Information 
IKJEGCIWV jis entered from IKJEGMNL via a LINK macro instruction. 


Input Parameters 


Parameters received by IKJEGCIV include the subcommand name field ECTSCMD } 
in the ECT and the INBUF field in TCOMTAB that points to the buffer containing 
the command and possible command operands. Register 9 points to TCOMTAB. 
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Function 


Data Areas 


Routines Called 


IKJEGCIV calls the BLDL routine to determine that the specified command is 
valid. If it is valid, it is attached as a subtask of TEST. The subcommand that 
was entered in TEST mode and the command processor parameter list are passed 
to the command as input parameters. 


Created: IKJEGCIV creates no data areas. 


Updated: IKJEGCIV updates the TPLCBUF field in the TPL, the INBUF and 
TSTHTCB fields in TCOMTAB, and the ECTPCMD field in the ECT. 


Consulted: IKJEGCIV consults the ECBTMPA, ECBTERM, and ECBLOG fields in 
TCOMTAB. 


TSO: IKJEGCIV calls the following TSO routines: 

e IKJDAIR, to release all data sets allocated by the subtask. 

e IKJEGIO, to issue error messages to the terminal user. 

System: IKJEGCIV calls the following system routines: 

e STAE, to establish an abnormal termination exit. 

e FREEMAIN, to free the main storage used for a terminal input buffer. 
e BLDL, to determine if the command specified is valid. 

e ATTACH, to create the subtask that processes the command. 

¢ WAIT, to determine that one or more events has completed. 


e DETACH, to terminate the subtask that was created to process the command. 


Register Usage During Module Execution 


Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


Reg 2 _— Points to the ECT. 

Reg 9  ~=Points to TCOMTAB. 

Reg 10 Points to the general work area of IKJEGCIV. 
Reg 11 Points to the task parameter list (TPL). 


Reg 12 Used as a base register. 


IKJEGCIV exits to IKJEGMNL via an SVC 3 instruction pointed to by Register 14. 


IKJEGCIV has no output parameters. 


0 Normal return. 
16 Attention interruption occurred. 


20 Abnormal termination recovery occurred. 


IKJEGCIM is the message CSECT for this module. 
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IKJEGCPY-COPY Subcommand Processor 


Diagram 2.5 contains the method-of-operation information for this module. 


Entry Information ) 


IKJEGCPY is entered either from IKJEGMNL at entry point IKJEGCPY via a LINK 
macro instruction or from IKJPARS at entry point IKJEGFM, IKJEGTO, or 
IKJEGLN. 


Input Parameters 


Register 9 points to TCOMTAB, and the INBUF field in TCOMTAB points to the 
input buffer that contains the subcommand. 


Function! : 
IKJEGCPY copies data from storage to storage, from register to register, from 
register to storage, and from storage to register. It also obtains addresses, and it 
places these either in storage or in a register. 

Data Areas 


Created: IKJEGCPY creates WA, its work area. 


Updated: IKJEGCPY updates the user registers and storage areas into wHich the 
data was copied, and it updates the ABENTABI, TSTRETRY, and TSTFLGS¢4 fields 
in TCOMTAB. 


Consulted: IKJEGCPY consults the WORKAREA field in TCOMTAB, the subtask for 
the problem program, and the CVT. 


Routines Called 
TSO: IKJEGCPY calls the following TSO routines: 


e The SVC 97 routine, to check the validity of addresses and to copy register J 
contents into the RB save area. 


« IKJPARS, to check the syntax of the subcommand operands. 
e IKJEGCVT, to convert values and addresses. 
« IKJEGBLD, to attach addresses to error messages. 


e« IKJEGSRH, to locate or remove break elements within the range specified by 
the user. 


e IKJEGIO is called to write data to a terminal or a data set. 
System: IKJEGCPY calls the following system routines: 
e STAE, to establish an abnormal termination exit. 


e FREEMAIN, to free main storage used as work areas. 


Register Usage during Module Execution ; 


Reg 2 ‘Points to the parameter descriptor list PDL used by the main routine of 
IKJEGCPY. It is also used by the validity check routine as a pointer to 
the PDE. 


Reg 3. _—Used as a work register. 
Reg 4 ~~ Used as a work register. 
Reg 5 Used as a work register. 


Reg 6 ~~ Used as a work register. 





Reg 7 Used as a work register. 

Reg 8 _— Points to the PDL passed from IKJPARS. 

Reg 9 = Points to TCOMTAB. 

Reg 10 Points to the work area used by IKJEGCPY. 
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( Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


Reg 11 Used as an internal link register. 
Reg 12 Used as a base register. 


IKJEGCPY exits to the Supervisor Exit routine via an SVC 3 instruction pointed to 
by Register 14. 


IKJEGCPY has no output parameters. 


0 Normal or error return. 
16 Attention interruption encountered during processing. 


20 —=«~STAE retry routine entered. 


IKJEGMGC is the message CSECT for this module. 


IKJEGCVT-Convert Module 


Entry Information 


Input Parameters 





Diagram 2.24 contains the method-of-operation information for this module. 
Figure 8 and Figure 9 in Section 1 provide additional information for this 
module. 


IKJEGCVT is invoked both directly and indirectly by subcommand processors. It 
is invoked directly to convert values to binary or printable form, and it is invoked 
indirectly, through a validity check exit routine from IKJPARS, to convert 
addresses to binary. 


Subommand Module Name Invokes Directly | Invokes Indirectly 
Processor 


Assignment IKJEGPCH 
AT IKJEGAT 
CALL IKJEGGO 
EQUATE IKJEGEQU 
FREEMAIN IKJEGLDF 
IKJEGGO 
IKJEGLST 
LISTDCB IKJEGDCB 
LISTDEB IKJEGDEB 
LISTPSW IKJEGPSW 
LISTTCB IKJEGTCB 
OFF IKJEGOFF 
QUALIFY IKJEGQFY 
RUN IKJEGGO 
WHERE IKJEGWHR 


«KK mK KK KK OK KKK OK OK OK OK 


IKJEGINT receives its input parameters from Register 0, Register 1, and a PDE 
that describes the address or value to be converted. 


For address conversion to binary form, Register 0 is positive, indicating 
conversion to binary, and Register 1 is negative, indicating an address is to be 
converted. Register 1 also points to an address PDE. The type of address and 
the PDEFLG4 indicator in the PDE follow. 
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Type of PDEFLG 4 


Address in PDE 

Absolute ABSADDR - ‘00° 

Relative RELADDR - ‘40’ ; 
Symbolic SYMADDR - ‘80’ 
Register GENR - ‘20’ 3 
Entry Name CTONLY - ‘04’ 

Only 


For address conversion to printable form, Register 0 is negative, indicating 
conversion to printable form, and Register 1 is negative, indicating an address 


conversion. Register 1 also points to an address PD!. The type of address and 
the PDEFLG4 indicator in the PDE follow. 


Type of PDEFLG 4 F 
Address in PDE 

Absolute ABSADDR - 00’ 

Relative RELADDR - ‘10° : 
Other Non- Codes Other Than 

Absolute Types the Above 


For value conversion from binary, Register 0 is negative, indicating conversion Lo 
printable form, and Register | is positive, indicating value conversion. Register | 
also points to a value PDE. The type of conversion and the hexadecimal codé 
located at offset plus seven in the PDE follow. 


Type of Hex Code 
Conversion in PDE 
Hexadecimal '04' 
Instruction ‘OC’ 
Fixed Point ‘10’ or ‘14 
Decimal 
Floating Point ‘1C’ or (18 
Decimal 
Constants A - '20' . ) 
Y - ‘24 
S - ‘28’ 
V -'2C 
Packed Decimal ‘30’ 


For value conversion to binary form, Register 0 is positive, indicating conversion 
to binary form, and Register 1 is positive, indicating a value conversion. Register 
1 also points to a value PDE. The type of conversion and the hexadecimal code 
located at offset plus seven in the PDE follow. 


Type of Hex Code 
Conversion in PDE 
Hexadecimal 04 
Binary ‘08’ : 
Fixed Point ‘10° or ‘14 7 
Decimal 
Constants A ‘20 
Y - ‘24 
Vi '2C' * 
S Constant ‘28° 
Packed Decimal ‘30’ 


Function 


Certain TEST subcommand processors receive input addresses which they must 

convert to binary before they can process the addresses. Similarly, various 
subcommand processors wish to convert values to printable form in order to list 

the values in a message to the terminal or to include the values on the print data 

set. To convert addresses and values to binary or printable form, the 

subcommand processors invoke IKJEGCVT. This module is invoked directly by a 
subcommand processor for value conversion and indirectly, through a validity J 
check exit routine from IKJPARS, for address conversion. 


a 
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C 


Data Areas 


Routines Called 


Created: IKJEGCVT creates no data areas. 


Updated: IKJEGCVT updates the PDEUSER field of the input PDE and the 32-byte 
work area pointed to by the CONAREA field of TCOMTAB. 


Consulted: IKJEGCVT consults the PDE and TCOMTAB. 


TSO: IKJEGCVT calls the following TSO routines: 


¢ IKJEGSYM, to resolve all symbolic addresses as well as for the symbolic part of 
address expressions. IKJEGSYM sets the first byte of the user word (PDEUSER) 
of the address PDE to X‘80’ and sets the remaining three bytes to point to a 
symbol information block (SYMINFO), whose first word contains the binary 
representation of the address. 


e The SVC 97 routine, to validity check an address. 


System: IKJEGCVT calls no system routines. 


Register Usage during Module Execution 


Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


Reg 3___— Points to the work area used in address conversion. 
Reg 8 Used with IKJPARMA DSECT to address the fields in a PDE. 
Reg 9 __—sC—wPPoints to TCOMTAB. 


Reg 12 Used as a base register. 


IKJEGCVT exits to the caller via a branch on Register 14. 


IKJEGCVT places the converted output in either of two locations, depending on 
the type of conversion. If it has converted an address to binary form, it places 
the binary address in the PDEUSER field of the input PDE. (See Section 5, “‘Data 
Areas” for the IKJPARMA DSECT.) All other converted outputs (addresses or 
values) are placed in a 32-byte work area that is pointed to by the CONAREA 
field of TCOMTAB. 


0 Normal return. 
4 Value not converted. 


16 Attention interruption encountered during processing. 


IKJEGMSF is the message CSECT for this module and has four entry points: 
IKJEGIIA, IKJEGMO1, IKJEGMO2, and IKJEGMO3. 


IKJEGDCB-LISTDCB Subcommand 


Entry Information 


Diagram 2.14 contains the method-of-operation information for this module. 


IKJEGDCB is entered from IKJEGMNL at entry point IKJEGDCB via a LINK macro 
instruction. 
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Input Parameters 


Function 


Data Areas 


Routines Called 


IKSJEGDCB receives the contents of the input buffer, and Register 9 points to , 
TCOMTAB. J 


IKJEGDCB processes the LISTDCB subcommand, which displays all or part of a 

specified data control block either to a user terminal or to a specified data set. 

After receiving control from IKJEGMNL, the module performs initialization 

processing. IKJEGDCB formats data from the DCB and converts data to 

hexadecimal via a branch to IKJEGCVT. IKJEGDCB then prints data via a branch 

to IKJEGIO and returns control to IKJEGMNL. : 


Created: IKJEGDCB creates DCBWKARA, its work area. - 
Updated: IKJEGDCB updates no data areas. 
Consulted: IKJEGDCB consults TCOMTAB, the CVT, and the TCB of TEST. 


TSO: IKJEGDCB calls the following TSO routines: 

e IKJPARS, to check the syntax of the subcommand operands. 

e IKJEGCVT, to convert values to printable characters and to convert addresses. 

e IKJEGIO, to write data to a terminal or a data set. 

e IKJEGBLD, to build a character symbolic address. 

System: IKJEGDCB calls the following system routines: ia 
e STAE, to establish an abnormal termination exit. 

e FREEMAIN, to free main storage used as work areas. 


e LINK, to invoke IKJPARS. 


Register Usage during Module Executiion 


Exit Information 


Output Parameters 


Return Codes 


Message CSECT 
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Reg 3 _— Points to the DCB that is being processed. 
Reg 5 ___—~ Points to the work area of IKJEGDCB. 
Reg 9 ~=— Points to TCOMTAB. 


Reg 12 Used as a base register. - 


IKJEGDCB exits to IKJEGMNL via an SVC 3 pointed to by Register 14. : 
The output from IKJEGDCB consists of lines to a terminal or a data set. 

QO Normal return. 

16 Attention interruption encountered during processing. 


20‘ STAE retry routine entered. 


IKJEGMSG is the message CSECT for this module. 


C 


iIKJEGDEB-LISTDEB Subcommand Processor 


Entry Information 


Input Parameters 


Function 


Data Areas 


Routines Called 


Diagram 2.15 contains the method-of-operation information for this module. 


IKJEGDEB is entered from IKJEGMNL at entry point IKJEGDEB via a LINK macro 
instruction. 


IKJEGDEB receives the contents of the input buffer, and Register 9 points to 
TCOMTAB. 


IKJEGDEB processes the LISTDEB subcommand of TEST. The LISTDEB 
subcommand lists the basic section and any direct access sections of a DEB to a 
terminal or to a user specified data set. IKJEGDEB determines which of the fields 
in the basic section or direct access sections of a DEB has been requested by the 
user and then branches to a specific subroutine for that field. Each of these 
subroutines uses a common conversion and Writing routine within IKJEGDEB. 


Created: IKJEGDEB creates DBWKAREA, its work area. 
Updated: IKJEGDEB updates no data areas. 
Consulted: IKJEGDEB consults TCOMTAB, CVT, and the TCB of TEST. 


TSO: IKJEGDEB calls the following TSO routines: 

e IKJPARS, to syntax check the syntax of the subcommand operands. 

e IKJEGCVT, to convert values to printable characters and to convert addresses. 
e IKJEGIO, to write data to a terminal or a data set. 

System: IKJEGDEB calls the following system routines: 

e STAE, to establish an abnormal termination exit. 

e LINK, to invoke IKJPARS. 


e FREEMAIN, to free main storage used as work areas. 


Register Usage during Module Execution 


Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


Reg 5 Points to DBWKAREA, the work area used by IKJEGDEB. 
Reg 9 Points to TCOMTAB. 


Reg 12 Used as a base register. 
. 


IKJEGDEB exits to IKJEGMNL via an SVC 3 instruction pointed to by Register 14. 
The output from IKJEGDEB consists of output lines to a terminal or a data Set. 

0 Normal return. 

16 Attention interruption encountered during processing. 


20 —«STAE retry routine entered. 


IKJEGDBM is the message CSECT for this module. 
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IKJEGEND-END Subcommand Processor 


Entry Information 


Input Parameters 


Function 


Data Areas 


Routines Called 





Diagram 2.8 contains the method-of-operation information for this module. J 


IKJEGEND 1s entered from IKJEGMNL via a LINK macro instruction. 


Register 9 points to TCOMTAB. 


IKJEGEND cleans up at the end of TEST processing and frees the Subpooll main 
storage of TEST. IKJEGEND transfers control to IKJEGOFF to remove all 
breakpoints. 


Created: IKJEGEND creates no data areas. 


Updated: IKJEGEND updates the CALLPARM, TSTIODSN, TSTIODCB, TSTSYMWK, 
TSTFLG1, and TSTDCB fields in TCOMTAB. 


Consulted: IKJEGEND consults TCOMTAB. 


TSO: IKJEGEND calls the following TSO routine: 

e IKJEGIO, to issue messages. 
System: IKJEGEND calls the following system routines: aa 
e STAE, to establish an abnormal termination exit. 

e FREEMAIN, to free Subpooll main storage of TEST. 

e XCTL, to transfer control to IKJEGOFF. 


e CLOSE, to close any open DCBs. 


Register Usage during Module Execution 


Exit Information 
Output Parameters 
Return Codes 


Message CSECT 


Reg 9 _ ~—s— Points to TCOMTAB. 


Reg 12 Used as a base register. 


IKJEGEND transfers control to IKJEGOFF to deactivate all remaining breakpoints. 


IKJEGEND has no output parameters. 


IKJEGEND has no return codes. 


IKJEGMSG is the message CSECT for this module. 


IKJEGEQU-EQUATE and DROP Subcommand Proéessor ia 
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This module’s alias is IKJEGDRP. Diagram 2.9 and Diagram 2.7 contain the 
method-of-operation information for this module. 


Entry Information 


Input Parameters 


Function 


Data Areas 


Routines Called 


IKJEGEQU ts entered from IKJEGMNL via a LINK macro instruction at either 
entry point IKJEGEQU or IKJEGDRP. 


IKJEGEQU receives the contents of the input buffer, and Register 9 points to 
TCOMTAB. 


IKJEGEQU processes the EQUATE and DROP subcommands of TEST. The 
EQUATE subcommand builds and maintains the symbol table located in main 
storage. The DROP subcommand deletes a specified entry or entries from the 
table. 


Created: IKJEGEQU creates a symbol table in main storage and AREAWORK, a 
work area. 


Updated: IKJEGEQU updates the symbol table in main storage, if it already exists. 
Consulted: IKJEGEQU consults TCOMTAB, CVT, and the TCB of TEST. 


TSO: IKJEGEQU calls the following TSO routines: 

e IKJPARS, to check the syntax of the subcommand operands. 

e IKJEGCVT, to convert values to printable characters and to convert addresses. 
e IKJEGIO, to write data to a terminal or a data set. 

e IKJEGBLD, to build a character symbolic address. 

System: IKJEGEQU calls the following system routines: 

e STAE, to establish an abnormal termination exit. 

e GETMAIN, to obtain main storage for the symbol table to be built. 


e FREEMAIN, to free main storage used for the symbol table. 


Register Usage during Module Execution 


Exit Information 
Output Parameters 


Return Codes 


Message CSECT 


Reg 8 Points to a PDL. 
Reg 9 ~=— Points to TCOMTAB. 
Reg 10 Points to ARE AWORK, the work area of IKJEGEQU. 


Rey 11 Used as a base register. 

IKJEGEQU exits to IKJEGMNL via an SVC 3 instruction pointed to by Register 14. 
IKJEGEQU has no output parameters. 

0 Normal return. 

16 Attention interruption encountered during processing. 


20 = STAE retry routine entered. 


IKJEGMSG is the message CSECT for IKJEGEQU. 
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IKJEGGO-GO Subcommand Processor 


Diagrams 2.12, 2.4, and 2.22 contain the method-of-operation information for : 
this module. This module’s aliases are IKJEGRUN and IKJEGCAL 
Entry Information 


[KJEGGO is entered either from IKJEGMNL via a LINK macro instruction to entry 
point IKJEGGO, IKJEGRUN, or IKJEGCAL or from IKJPARS via a branch to entry 
point ADDRCHK. 


Input Parameters 
iKJEGGO recieves the contents of the input buffer, and Register 9 points to 
FCOMTAB. 

Function 


IKJEGGO processes the GO, CALL, and RUN subcommands of TEST. For all three 
subcommands, control blocks are altered to cause the problem program to receive 
control either at an address specified in the subcommand or at the next 
instruction in the problem program. For the RUN subcommand, the problem 
program is removed from the control of TEST. For the CALL subcommand, the 
problem program’s Registers 1, 14, and 15 are altered to contain, respectively, 
the address of a parameter list, the address of a breakpoint SVC or the return 
address supplied in the subcommand, and the address at which control is passed 
to the problem program. 


Data areas 


Created: IKJEGGO creates the CALL parameter list which is chained from the 
CALLPARM field of TCOMTAB. 


Updated: IKJEGGO updates the CALLPARM, ABENTAB!, RUNSW, TSTRTYPT, and 
TSTFLGS4 fields in TCOMTAB and the PDEUSER field in the PDE. 


Consulted: IKJEGGO consults the BRKELEM, the TCB, the CVT, the RB, the PDL, 
and the following fields in TCOMTAB: TSTTCB, PPTCB, OUTBUF, WORKAREA, 
REGL.1. 22, REGSAVE3, PARMLIST, TSTANSPL, INBUF, TPUTADDR, TSTCONVT, 
TSTADDR, TSTSTAE, TSTFLGS3, BREAKTAB, and PPRB. 


Routines Called 
TSO: IKJEGGO calls the following TSO routines: 
e IKJPARS, to check the syntax of the subcommand operands. : 
» IKJEGIO, to write data to a terminal or a data set. 
e IKJEGCVT, to convert values to printable characters and to convert addresses. , 
e The SVC 97 routine, to set the resume address and wait count. 
¢ IKJEGBLD, to build a character symbolic address. 
System: IKJEGGO calls the following system routines: 
e STAE, to establish an abnormal termination exit. 
e GETMAIN, to obtain main storage for work areas. 
e FREEMAIN, to free main storage used as work areas. 
e LINK, to invoke IKJPARS. — 





Register Usagé during Module Execution 


Reg 6 ‘Points to the common work area described by TSTCWORK. 


154 TSO Test | 


C Exit Information 


Output Parameters 


: Return Codes 


Message CSECT 


Reg 9 ~— Points to TCOMTAB. 
Reg 11 Reserved for maintenance. 


Reg 12 Used as a base register. 


IKJEGGO exits to IKJEGMNL. 


RUNSW is set on if processing completes normally. In all other cases, RUNSW is 
off. 


0 System error; recoverable non-zero return code from the SVC 97 routine. 
Normal end for GO and CALL. 


12 Normal end for the RUN subcommand if the RUNSW is set; unrecoverable 
non-zero return code from the SVC 97 routine if RUNSW is off. 


16 Attention interruption encountered during processing. 


20 =STAE retry routine entered. 


IKJEGMSG is the message CSECT for IKJEGGO. 


IKJEGINT-Initialization Module 


C Entry Information 


Input Parameters 


Function 


Diagram 1 contains the method-of-operation information for this module. 


IKJEGINT is entered from one of the following: 
e The TMP via a LINK macro instruction. 


e The SVC 97 routine (IGC0009G) after a pseudo or user breakpoint has been 
encountered via POST and WAIT macro instructions. 


e The ABEND/STAE Interface routine (IGCODO0IC) via the VS2 Dispatcher after 
a STAE-intercepted ABEND in IKJEGINT. 


Register 1 contains the address of the TEST Parameter List (TPL), when entered 
from the TMP. 


IKJEGINT performs the following functions: 


1. It allocates storage for tables, buffers, and work areas to be used during 
TEST execution. 


2. It issues the STAE macro instruction for the STAE Exit routine to handle a 
possible ABEND during initialization. 


It initializes part of TCOMTAB. 


4. It determines if the problem program is already a subtask of TEST/TMP. If 


so, the module proceeds with step 5. If not, the module prepares to bring the 
program into main storage as a subtask of TEST. It attaches IKJEGLDR to 
fetch or load the program. IKJEGINT then branches to step 8. If IKJEGLDR 
is not attached, IKJEGINT does steps 5 through 7; otherwise, IKJEGLDR does 
Steps 5 through 7. 
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Data Areas 


Routines Called 


156 


TSO Test 


4 


5. It moves the queue origin of the SVC Information Block chain (if it exists) 
from the problem program’s TCB to TCOMTAB. 


6. It ensures that the proble:n program is dispatchable by zeroing the program’s 
RB wait count. : 





7. It inserts a pseudo breakpoint to cause linkage from the problem program, 2 
when it is dispatched, to IKJEGINT. IKJEGLDR sets this pseudo breakpoint if 
the VS2 Loader loads the problem program. IKJEGINT further ensures 
program dispatchability by issuing a STATUS START or IN macro instruction. 


8. It waits to be posted from the SVC 97 routine (IGC0009G), after the problem 
program has been dispatched and has executed the pseudo breakpoint. 


9. When posted from the SVC 97 routine, it restores the saved restart address 
for the problem program. When it inserted the pseudo breakpoint, IKJEGINT ° 
or IKJEGLDR saved this restart address in TCOMTAB. 


10. It issues an XCTL macro instruction to purge IKJEGINT and the loading of 
IKJEGMNL and other TEST modules that are resident during the TEST session. ‘ 
The XCTL macro instruction transfers control to IKJEGMNL. 


Created: IKJEGINT creates TCOMTAB, the control chain words for the queue of 
SVC information blocks built by the SVC 61 routine, and the following work 
areas: CONAREA, a communication area; OUTBUF; WORKAREA; and REGSAVEI 
through REGSAVE6. 


Updated: IKJEGINT updates the TPL, the TCB belonging to the problem program, 
the TCB of TEST, the program request block (PRB) or interruption request block 
(IRB) belonging to the problem program, and TCOMTAB. 


Consulted: IKJEGINT consults no data areas. 


TSO: IKJEGINT calls the following TSO routines: 

e The SVC 97 routine, to put the address of TCOMTAB in the TCB. 

e IKJPARS, to check the syntax of the TEST command operands. 

e IKJDAIR, to allocate the data set specified in the TEST command. 

e IKJDFLT, to fully qualify the data set name. 

e IKJEGDDM, to generate the allocation failure message. 

© IKJEGLDR, to attach the problem program. 

¢ IKJEGIO, to write messages to the terminal user. ‘ 
e TSEVENT, to record the start of a TEST session. 

e IKJRLSA, to free the PDL of IKJPARS. : 
System: IKJEGINT calls the following system routines: 

e STAE, to establish an abnormal termination exit. 


e POST, to indicate completion of initialization processing to the SVC 61 routine 
or the SVC 97 routine. 


™ 


¢« BLDL, to determine if the program name specified in the TEST command is 
valid. 


e STATUS, to set the dispatchability of the problem program. 





e CLOSE, to release the data set specified in the TEST command. 


» XCTL, to transfer control to IKJEGMNL. 


« WAIT, to wait on event completion so that IKJEGINT processing can continue. 
« FREEMAIN, to free main storage used as work areas. 

e LINK, to invoke another load module. 

e GETMAIN, to obtain main storage for work areas. 


e ATTACH, to create the problem program task. 


Register Usage during Module Execution 


Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


IKJEGIO-1/O Module 


Entry Information 


Input Parameters 


Reg 9 ~=Points to TCOMTAB. 
Reg 10 Points to the TPL. 

Reg 11 Used as a link register. 
Reg 12 Used as a base register. 


IKJEGINT exits to IKJEGMNL via an XCTL macro instruction if processing is 
normal or to the TMP if an error is detected (e.g., BLDL error, IKJDAIR error, 
GETMAIN error, etc.). 


Register 9 points to TCOMTAB. 


0 Control passes to the TMP due to an error. 


Messages are contained in control section IKJEGXNT. This also is accessed by 
the STAE Exit routine of IKJEGINT to obtain inserts for second-level diagnostic 
messages. 


ABENDLST contains addresses of retry locations to which control returns if 
IKJEGINT abnormally terminates and the STAE Exit routine intercepts the 
ABEND. 


Diagram 2.26 contains the method-of-operation information for this module. 


IKJEGIO is entered from any TEST module (except IKJEGATN) via a branch 
instruction to one of three entry points: 


e IKJEGGT for input. 
e IKJEGPT for output. 


e IKJEGPG for output with a response requested. 


If IKJEGIO is entered at IKJEGPT and the TSTPRINT switch in TCOMTAB is set, 
Output goes to a data set. If Register 0 is ‘0’, the data set is already open. If 
Register 0 is not ‘0’, it points to a data set name PDE for the data set to be 
opened. Register 1 points to a doubleword; the first word points to output data, 
and the second word contains ‘0’. 


If the TSTPRINT switch in TCOMTAB is not set, Register 0 is not meaningful. 
However, if Register 1 is positive, the output is data. If Register | is negative, 
the output is a message. Register 1 also points to a doubleword; the first word 
points to the output data, and the second word points to a second-level message. 
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If the second word is zero, the output is not a message or there are no 
second-level messages. 


If IKJEGIO is entered at IKJEGGT and the SUBCHAIN field in TCOMTAB is 

non-zero, the module gets a subcommand from the subcommand chain built in J 
main storage by the AT subcommand processor. If the SUBCHAIN field is zero, a 
GETLINE macro instruction is issued to get a subcommand from the terminal. 


If IKJEGIO is entered at IKJEGPG, Register 1 points to a doubleword; the first 
word points to a first-level message, and the second word points to a 
second-level message, if one exists. This second word contains zero if no 
second-level message exists. 


Function . 
IKJEGIO handles three types of 1/O request from any module except IKJEGATN. 


For a GETLINE request, data is obtained from the terminal. A subcommand is 
obtained from the terminal, via a GETLINE macro instruction, if the SUBCHAIN 
pointer is zero. If, however, the SUBCHAIN pointer is not zero, IKJEGIO gets a 
subcommand from a subcommand chain built in storage by the AT subcommand. 


For a PUTGET request, IKJEGIO issues a TEST message and obtains a 
subcommand, either from the terminal (via a PUTGET macro instruction), or 
from a list in storage, as with a GETLINE request. 


For a PUTLINE request, the IKJEGIO prints a line of data or a message to the 
terminal. It can send output to a print data set, if such action is requested by 
one of the LIST subcommands. In the latter case, the PRINT keyword was 
specified in the subcommand. 


Data Areas 


Created: IKJEGIO creates no data areas. 





Updated: IKJEGIO updates the INBUF and SUBCHAIN fields in TCOMTAB. 


Consulted: IKJEGIO consults the TSTPRINT switch in the TSTFLGS| field and the 
SUBCHAIN field of TCOMTAB, the ECBTMPA, and the ECBLOG. 


Routines Called 

TSO: IKJEGIO calls the following TSO routines: 

e GETLINE, to get input from the terminal. 

e PUTLINE, to issue a message or data to a terminal. 

¢ PUTGFT, to issue a mode message to a terminal and receives a response. 4 

e IKJDAIR, to allocate the output data set. 

System: IKJEGIO calls the following system routines: 

e OPEN, to open the output data set. 

e CLOSE, to close the output data set. 

¢ PUT, to write variable blocked (VB) records to an output data set. 
Register Usage during Module Execution 

Reg 9 ~=— Points to TCOMTAB. 


Reg 12 Used as a base register. 


Exit Information 7 
IKJEGIO exits to the caller via a branch on Register 14. 





Output Parameters 
IKJEGIO has no output parameters. 
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Return Codes 


Message CSECT 


Normal return. 
Error encountered. 


16 Attention request or an operator STOP/MODIFY TS command encountered 
during processing. 


IOMSGCST is the message CSECT for IKJEGIO. 


IKJEGLDF-DELETE, FREEMAIN, GETMAIN and LOAD Subcommand Processor 


Entry Information 


Input Parameters 


Function 


Data Areas 


Routines Called 


The aliases IKJEGLDF uses are IKJEGDEL, IKJEGFRE, IKJEGGET, and IKJEGLOD. 
Diagrams 2.6, 2.10, 2.11, and 2.19 contain the method-of-operation information 
for this module. 


IKJEGLDF is entered via a LINK macro at one of four entry points - IKJEGLOD, 
IKJEGDEL, IKJEGGET, or IKJEGFRE. 


IKJEGLDF receives the contents of the input buffer, and Register 9 points to 
TCOMTAB. 


IKJEGLDF processes the following subcommands of TEST: 
e DELETE, which removes the problem program. 
e FREEMAIN, which frees a specified number of bytes for the problem program. 


e GETMAIN, which acquires a specified number of bytes for the problem 
program. 


e LOAD, which loads a specified problem program. 


Created: IKJEGLDF creates the SIB. 


Updated: IKJEGLDF updates the ABENTABI, TSTRETRYI, TSTDCB and 
SYMTABLE fields in TCOMTAB. 


Consulted: IKJEGLDE consults TCOMTAB and the Dynamic Allocation Interface 
routine (DAIR) parameter block. 


TSO: IKJEGLDF calls the following TSO routines: 

e IKJPARS, to check the syntax of the subcommand operands. 

e IKJDAIR, to allocate the data set specified in the TEST command. 

¢ IKJDFLT, to fully qualify the data set name. 

e IKJEGCVT, to convert values to printable characters and to convert addresses. 
e IKJEGIO, to write data to a terminal or a data set. 

e The SVC 97 routine, to put the address of TCOMTAB in the TCB. 

System: IKJEGLDF calls the following system routines: 


e OPEN, to initialize system routines necessary to access a data set. 
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e CLOSE, to release the specified data set. 


e LOAD, to bring a copy of a load module into main memory. 





* DELETE, to delete a copy of a load module from main storage. : 
e GETMAIN, to obtain main storage for work areas. J 
e FREEMAIN, to free main storage used as work areas. 

e STAE, to establish an abnormal termination exit. 

e LINK, to invoke IKJPARS. 


¢ BLDL, to determine if the program with the specified name exists. 


Register Usage during Module Execution - 


Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


Reg 9 = Points to TCOMTAB. 
Reg 11 Used as an error message pointer. 


Reg 12 Used as a base register. 


IKJEGLDF exits to IKJEGMNL via an SVC 3 instruction pointed to by Register 14. 


IKJEGLDF has no output parameters. 


4 Normal return. 
16 Attention interruption encountered during processing. 


20 = STAE retry routine entered. 





IKJEGMSG is the message CSECT for IKJEGLDF. 


IKJEGLDR-Load Module 


Entry Information 


Input Parameters 


Function 


160 


TSO Test 


Diagram 1.1 contains the method-of-operation information for this module. 


IKJEGLDR is entered from IKJEGINT via an ATTACH macro. Control is obtained 
from the VS2 Dispatcher when IKJEGINT waits. 


IKJEGLDR receives the following input parameters: 
e Register 1 points to TCOMTAB. 
e The address of the TPL, contained in the TPLPTR field of TCOMTAB. 


e The DCB for the problem program’s data set, queued from the TSTDCB field of 
TCOMTAB. 


e The BLDL entry obtained by IKJEGINT and pointed to by BLDLAREA (equated 
to the CONAREA field in TCOMTAB). 


e The PDL for the TEST command pointed to by the TSTANSPL field in | 
TCOMTAB. ) 


This module performs the following functions: 


Data Areas 


Routines Called 


1. It determines whether the problem program is a load module or an object 
module. 


2. It sets a pointer to TCOMTAB in the TCB of the TEST Loader It also indicates 
in the TCB that the TEST Loader and the problem program are a subtask of 
TEST. 


3. It loads the problem program using either Contents Supervision via an XCTL 
macro instruction or the VS2 Loader, IEWLOAD, as determined by step 1. 


4. It builds an input parameter list for the problem program. 


5. It prompts for an input line if the CP keyword was specified in the TEST 
command. 


6. It transfers control via an XCTL macro instruction to the entry point of the 
problem program to execute a pseudo breakpoint. The pseudo breakpoint 
passes control, via the SVC 97 routine back to IKJEGINT. 


Created: IKJEGLDR creates the parameter list for the problem program. 
Updated: IKJEGLDR updates the TCOMTAB, CPPL, ECT, and TPL control blocks. 


Consulted: IKJEGLDR consuls the following control blocks: TCOMTAB, 
TSTCWORK, CDE, PDL, CVT, ECT, TCB, TPL, and LLE. 


TSO: IKJEGLDR calls the following TSO routines: 
e The SVC 97 routine, to issue an SVC to set fields within a TCB. 
e IKJEGIO, to issue an error message. 


e IKJSCAN, to scan the verb field of the command being sent to the command 
processor. 


System: IKJEGLDR calls the following system routines: 
e DELETE, to delete a copy of a load module from main storage. 


e FREEMAIN, to free main storage used as work areas. 


Register Usage during Module Execution 


Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


Reg 9 ~=— Points to TCOMTAB. 
Reg 10 Points to the TPL.. 
Reg 11) Used as a link register. 


Reg 12 Used as a base register. 


IKJEGLDR normally exits to the entry point of the problem program via an XCTL 
macro instruction. When an error occurs, it exits to IKJEGINT via a branch on 
Register 14. 


Register 1 contains a pointer to the address of the parameter list for the problem 
program. 


0 Normal return. 


A Terminal [/O error encountered during processing. 


IKJEGXDR is the message CSECT for this module. 
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IKJEGLSA-LIST Subcammand Processor, Second Load Module 


Diagram 2.13 contains the method-of-operation information for this module. | ) 





Entry Infarmation 
IKJEGLSA is entered from IKJEGLST at entry point IKJEGLSA via an XCTL macro 
instruction. 

Input Parameters 
Register 9 points to TCOMTAB. 


Function 
IKJEGLSA is the second load module that processes the LIST subcommand. It is 
entered from IKJEGLST when the output data type requested by the user is one : 
of the following: 
A or V_ Address constant. 
B Binary. 
C Character. 
DorE_ Floating point. 
For H_ Fixed point. 
I Instruction. 
P Packed. 
S S-type address constant. ‘ J 
y Y-type address constant. 
ZL Zoned decimal. 
Data Areas 


Created: IKJEGLSA creates no data areas. 


Updated: IKJEGLSA updates MYWORK, a work area used by both IKJEGLST and 
IKJEGLSA. 


Consulted: IKJEGLSA consults TCOMTAB, the CVT, and the 1CB of TEST. 
Routines Called 

TSO: IKJEGLSA calls the following ‘TSO routines: 

e IKJEGCVT, to convert values to printable characters and to convert addresses. 

e IKJEGIO, to write data to a terminal or a data set. 

System: IKJEGLSA calls the following system routine: 

e« FREEMAIN, to free main storage used as work areas. 
Register Usage during Module Execution 

Reg 9 ~=Points to TCOMTAB. 

Reg 10 Used as a base register for MYWORK, the work area. 


Reg 12 Used as a base register. 





Exit Information 


IKJEGLSA exits to IKJEGMNL via an SVC 3 instruction pointed to by Register 14 
or to IKJEGLST via an XCTL macro instruction. 
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Output Parameters 


Return Codes 


Message CSECT 


IKJEGLSA issues output to a terminal or a data set. 


0 Normal return. 
16 Attention interruption encountered during processing. 


20 = STAE retry routine entered. 


IKJEGMSB is the message CSECT for IKJEGLSA. 


IKJEGLST-LIST Subcommand Processor, First Load Module 


Entry Information 


Input Parameters 


Function 


Data Areas 


Routines Called 


Diagram 2.13 contains the method of operation information for this module. 


IKJEGLST is entered from th: IKJEGMNL via a LINK macro instruction at entry 
point IKJEGLST. IKJEGLST is also entered from IKJEGLSA via an XCTL macro 
instruction. 


IKJEGLST receives the contents of the input buffer, and Register 9 points to 
TCOMTAB. 


IKJEGLST processes the LIST subcommand of TEST. This subcommand is used to 
write in hexadecimal format the contents of an area of main storage or the 
contents of registers. 


IKJEGLST is the first of a double load module that processes the subcommand, 
and it performs three functions. 


e It establishes limits and default values for the type of data requested by the 
user. 


e It lists the contents of the general and floating point registers. 


e It lists the requested contents of main storage in hexadecimal format. 


Created: IKJEGLST creates MYWORK and the work areas used by both IKJEGLST 
and IKJEGLSA. 


Updated: IKJEGLST updates no data areas. 


Consulted: IKJEGLST consults TCOMTAB, the PDL, the TCB of TEST, and the 
CVT. 


TSO: IKJEGLST calls the following TSO routines: 


« IKJPARS, to check the syntax of the subcommand operands and to build a PDE 
for the PDL. 


e IKJEGCVT, to convert values and addresses to printable form. 
e IKJEGIO, to write data to a terminal or a data set. 


System: IKJEGLST calls the following system routines: 
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e STAE, to establish an abnormal termination exit. 
e LINK, to invoke IKJPARS. 


e XCTL, to transfer control to IKJEGLSA. 





Register Usage During Module Execution 
Reg 9 Points to TCOMTAB. 


Reg 10 Used as a base register for MYWORK, the work area. 


Reg 12 Used as a base register. 


Exit Information 


IKJEGLST exits to IKJEGLSA via an XCTL macro instruction if the data being 
considered is not hexadecimal data or register information. 


Upon completion of the needed function, exit is to IKJEGMNL via an SVC 
instruction pointed to by Register 14. 


Output Parameters 


IKJEGLST issues output to a terminal or a data set. 
Return Codes 

0 Normal return. 

16 Attention interruption encountered during processing. 

20 ~=STAE retry routine entered. 


Message CSECT 
IKJEGMSA is the message CSECT for IKJEGLST. 





IKJEGMAP-LISTMAP Subcommand Processor 


Diagram 2.16 contains the method-of-operation information for this module. 


Entry Information 
IKJEGMAP is entered from IKJEGMNL by a LINK macro instruction. 


Input Parameters 


IKJEGMAP receives the contents of the input buffer, and Register 9 points to 
TCOMTAB. 


Function 


IKJEGMAP processes the LISTMAP subcommand of TEST. This subcommand is 

used to write to a terminal or to a data set the following information: the user's : 
region size; address of the problem program’s TCB; the names, addresses, and 

lengths of all programs running under the problem programs TCB,; the type and 

program identification of all active RBs; and the user subpool numbers, locations, 

and number of bytes used. 


IKJEGMAP gathers the specified information by means of a series of pointers. It 
formats the data and prepares it to be written. 


Data Areas 


Created: IKJEGMAP creates no data areas. 





Updated: IKJEGMAP updates no data areas. 
Consulted: IKJEGMAP consults TCOMTAB, the CVT, the TCB of TEST, the LLE 
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C 


Routines Called 


(load list element), the CDE (contents directory entry), the RB, the SPQE 
(subpool queue element), the PQE (partition queue element), the DQE (descriptor 
queue element), and the XTLST (extent list). 


TSO: [IKJEGMAP calls the following TSO routines 


e IKJPARS, to check the syntax of the subcommand operands and to build a PDE 
for the PDL. 


e IKJEGCVT, converts values and addresses to printable characters. 
e IKJEGIO, to write data to a terminal or a data set. 

System: IKJEGMAP calls the following system routines: 

e STAE, to establish an abnormal termination exit. 


¢ FREEMAIN, to free main storage used as work areas. 


Register Usage during Module Execution 


Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


Reg 9 ~=— Points to TCOMTAB. 


Reg 12 Used as a base reg’ster. 


IKJEGMNL exits to IKJEGMNL via an SVC instruction pointed to by Register 14. 


IKJEGMAP issues output to a terminal or a data set. 


0 Normal return. 
16 Attention interruption encountered during processing. 


20 ~=STAE retry routine entered. 


IKJEGMSG is the message CSECT for IKJEGMAP. 


IKJIEGMNL-Mainline Module 


Entry Information 


Diagrams 1, 2, and 3 contain the method-of-operation information for this 
module. 


IKJEGMNL can be entered at six places: 
e The initial entry to IKJEGMNL is for TEST initialization at location IKJEGMNL. 


e Entry can be from the SVC 97 routine, IGC0009G, after a pseudo or user 
breakpoint has been encountered. Linkage is via the POST and WAIT macro 
instructions. 


¢« Entry can be from the SVC 61 routine, IGCO006A, after a module of the 
problem program has been fetched for Contents Supervision or the Overlay 
Supervisor. Linkage is via the POST and WAIT macro instructions. 


e Entry can be from the TMP STAI Exit routine, IKJEFT04, after the problem 
program has begun to terminate abnormally during the test session. Linkage is 
via the POST and WAIT macro instructions. 


¢ Entry can be from the ABEND/STAE Interface routine, IGCODOIC, afer a 
STAE-intercepted ABEND in TEST. This is done via the OS/VS2 Dispatcher. 
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Input Parameters 


Function 


Data Areas 


Routines Called 


166 


TSO Test" 


e 


e Entry can be from the EOT routine of the Supervisor via the POST macro 
instruction. 


IKJEGMNL receives a parameter list from the TMP STAI exit routine, and Reigster J 
1 points to TCOMTAB. 


IKJEGMNL performs the following functions: 
« It completes the initialization of TCOMTAB. 
e It issues the STATUS macro instruction to stop and start the problem program. 


e It qualifies the problem program automatically on initial entry and each time 
that IKJEGMNL receives control from the SVC 97 routine because of a 
breakpoint that was encountered in a new module. If the previous module of 
the problem program attaches, links, or transfers control to another module, 
and then encounters a breakpoint, IKJEGMNL qualifies to the second module. 
An ABEND or a attention interrupt that occurs during execution of the 
problem program can cause requalification, since these conditions result in a 
psuedo breakpoint. 


e It gets a subcommand. 
e It tests the return code from the subcommand processor that executed. 
e It waits for an event to occur, as a result of the WAIT macro instruction. 


e It makes decisions after an abnormal termination in the TEST command 
pracessor. 


» It terminates TEST and returns to the TMP. } 


Created: IKJEGMNL creates the control chain word for the SVC 61 routine. The 
control chain word is queued from the TSTTRN field of TCOMTAB and is created 
only if the problem program has more than one task. The first control chain 
word is always built by IKJEGINT. 


Updated: IKJEGMNL updates TCOMTAB, the TPL, and subtask TCBs; IKJEGMNL 
frees the PDL, SIB, the symbol table built in storage, the input buffer, the 
TSTDCB queue, WORKAREA, TCOMTAB, CONAREA, OUTBUF, and REGSAVE|! 
through REGSAVE6. 


Consulted: IKJEGMNL consults TCOMTAB, the break element queuc, the defer 
element queue, and the TPL. 


TSO: IKJEGMNL calls the following TSO routines: 

e {KJEGIO, to obtain subcommands and to issue messages. 

e« The SVC 97 routine, to alter request block fields. 

e IKJDAIR, to unallocate data sets allocated by TEST modules. 


e IKJRLSA, to free the PDL used by the previously executed subcommand 
processor. 


e STACK, to add and remove a terminal element from the input stack. 





e Subcommand processors of the TEST command. 
System: IKJEGMNL calls the following system routines: 


e STAE, to create and queue a STAE control block for possible scheduling of the 
STAE Exit routine of TEST during IKJEGMNL execution. 


STAX, to create and queue a terminal attention exit element for use in the 
scheduling of the TEST attention exit routine during IKJEGMNL execution. 


GETMAIN, to obtain main storage for a control element for use by the SVC ol 
routine when it queues SVC information blocks. 


FREEMAIN, to free the input buffer before obtaining the next subcommand; 
also to release TEST’s storage before IKJEGMNL retruns to the TMP. 


LINK, to invoke a subcommand processor; also to call [IKJSCAN and IKJDAIR. 


POST, to prepare to return control to the SVC 97 routine, the SVC 61 routine, 
or the TMP’s STAI exit routine when IKJEGMNL has received control via a 
POST macro instruction from one of these routines. 


STATUS, to start or stop a subtask. 


WAIT, to stop IKJEGMNL execution and force the OS/VS2 Dispatcher to give 
control to the subtask. 


DELETE, to remove the IKJEGLDF module after IKJEGMNL has restored the 
problem program’s registers for IKJEGLDF. 


CLOSE, to close any open DCB after the LOAD subcommand has been invoked. 


Register Usage during Module Execution 
Reg 9 _ ~— Points to TCOMTAB. 


Reg 10 Points to the TPL. 


Reg 11 Used as a link register. 


Reg 12 Used as a base register. 


Exit Information 


Cc IKJEGMNL returns control to the TMP when one of the following events occurs: 


Output Parameters 


The RUN or END subcommand has been specified. 

The problem program task has no remaining request blocks. 

The user has entered a new command after pressing the attention key twice. 
An unrecoverable error has been detected by a TEST module. 


A critical abnormal termination occurred in IKJEGMNL. 


If the problem program begins to terminate abnormally, IKJEGMNL returns the 

. contents of the TPLNECB field of the TPL to the STAI Exit routine of the TMP. 
This field points to an ECB containing a retry POST code of X‘7F’ and the retry 
address. 


Return Codes 


0 


Message CSECT 


Normal return. 


IKJEGXNL is the message CSECT for IKJEGMNL. 


IKJEGOFF-OFF Subcommand Processor 


Diagram 2.20 contains the method-of-operation information for this module. 


C Entry Information 


IKJEGOFF is entered from IKJEGMNL via a LINK macro instruction or from 
IKJEGEND via an XCTL macro instruction. 
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Input Parameters 





IKJEGOFF receives the contents of the input buffer, and Register 9 points to J 
TCOMTAB. 
Function 


IKJEGOFF clears specified breakpoints from the problem program if address 
operands are included in the subcommand, AI] breakpoints are removed if no 
address operand is included, or if the end of TEST processing is indicated. The 
removed breakpoint is replaced with the original saved instruction. 


Data Areas 
Created: IKJEGOFF creates no data areas. 


Updated: IKJEGOFF updates the break element queue and the defer element 
queue. 


Consulted: IKJEGOFF consults the break element queue, the defer element queue, 
TCOMTAB, and the address of the PDE. 


Routines Called 
TSO: IKJEGOFF calls the following TSO routines: 
e IKJPARS, to check the syntax of the subcommand operands. 
e IKJEGIO, to issue messages. 
e The SVC 97 routine, to alter the problem program’s request blocks. 
e IKJEGSRH, to search for and remove breakpoints from the active queue. | 
e IKJEGBDL, to add an address string to an error message. J 
e IKJRLSA, to free the PDL. 
e IKJEGCVT, to convert values and addresses to printable characters. 
System: IKJEGOFF calls the following system routines: 
e FREEMAIN, to free queue elements being removed. 
e STAE, to establish an abnormal termination exit. 


e LINK, to invoke IKJPARS. 


Register Usage during Module Execution 
Reg 9 Points to TCOMTAB. 
Reg 10 Used as a base register for the work area. 
Reg 12 Used as a base register 
Reg 13 Points to save area used by IKJEGOFF. 


Exit Information 


IKJEGOFF exits to IKJEGMNL. Register 14 points to an SVC instruction that 
allows indirect return. 


Output Parameters 
IKJEGOFF has no output parameters. ) 


Return Codes 


0 Normal return or an error condition exists. 
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Message CSECT 


16 An attention interruption occurred. 


20 IKJEGOFF retry routine entered. 


IKJEGMSG is the message CSECT for IKJEGOFF. 


IKJEGPCH-Assignment Subcommand Processor, First Load Module 


Entry Information 


Input Parameters 


Function 


Data Areas 


Routines Called 


Diagram 2.2 contains the method-of-operation information for this module. 


IKJEGPCH is entered at any one of three locations. IKJEGMNL enters at entry 
point IKJEGPCH via a LINK macro instruction. IKJPARS enters at either 
PCHVALAD or PCHVALTP via a branch instruction. 


IKJEGPCH receives the contents of the input buffer, and Register 9 points to 
TCOMTAB. 


IKJEGPCH is the first of two load modules that process the assignment function 
of TEST. The assignment function changes values in memory and in registers. 
IKJEGPCH initializes the work area used by IKJEGASN, the second of the two load 
modules. IKJEGPCH issues a LINK macro instruction to IKJPARS to validate the 
operands. Upon completion, IKJEGPCH issues an XCTL macro instruction to 
IKJEGASN. 


Created: IKJEGPCH creates PCHWORK, its work area. 
Updated: IKJEGPCH updates TCOMTAB, the VALVPDE, the PDL, and the PPL. 


Consulted: IKJEGPCH consults TCOMTAB, TSTCWORK, the VALVPDE, the TCB, 
the PDL, the CVT, and PCHWORK. 


TSO: IKJEGPCH calls the following TSO routines: 

e IKJPARS, to check the syntax of the subcommand operands. 
e IKJEGCVT, to covert addresses to binary. 

e IKJEGIO, to issue output to the terminal. 

System: IKJEGPCH calls the following system routines: 

e STAE, to establish an abnormal termination exit. 

e LINK, to invoke IKJPARS. 

e FREEMAIN, to free main storage used as work areas. 


e XCTL, to transfer control to IKJEGASN. 


Register Usage during Module Execution 


Exit Information 


Reg 9 ~~ Points to TCOMTAB. 


Reg 11 Used as a base register. 


IKJEGPCH returns to IKJEGMNL by a branch instruction, if an error occurs during 
IKJPARS or IKJEGCVT execution, or if an attention interruption occurs, or if the 
STAE retry routine is executed. 
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Output Parameters 


Return Codes 


Message CSECT 


. IKJEGPCH has no output parameters. 


e 


IKJEGPCH exits to IKJEGASN via an XCTL macro instruction. 





0 Norma! return. 
16 Attention interruption encountered during processing. 


20 STAE retry routine entered. 


IKJEGMSG is the message CSECT for IKJEGPCH. - 


IKJEGPSW-LISTPSW Subcommand Processor 


Entry Information 


Input Parameters 


Function 


Data Areas 


Routines Called 


Register Usage During Module Execution 
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Diagram 2.17 contains the method-of-operation information for this module. 


IKJEGPSW is entered by IKJEGMNL at entry point IKJEGPSW via a LINK macro 
instruction. 


IKJEGPSW receives the contents of the input buffer, and Register 9 points to 
TCOMTAB. 


IKJEGPSW processes the LISTPSW subcommand of TEST. The subcommand writes | 
to a terminal or to a data set the contents of a program status word. } 


IKJEGPSW checks bit 12 of the PSW to determine the mode. If bit 12 contains a 
1, the PSW is formatted in EC (Extended Control) mode. If bit 12 contains a 0, 
the PSW is formatted in BC (Basic Control) mode. 


Created: IKJEGPSW creates PSWAREA, its work area. 
Updated: IKJEGPSW updates no data areas. 
Consulted: IKJEGPSW updates TCOMTAB. 


TSO: IKJEGPSW calls the following TSO routines: 

e IKJPARS, to check the syntax of the subcommand operands. 

e IKJEGCVT, to convert values to printable characters and to convert addresses. 
e IKJEGIO, to write data to a terminal or a data set. 

e IKJEGBLD, to build a character symbolic address. 

System: IKJEGPSW calls the following system routines: 

e STAE, to establish an abnormal termination exit. 

e LINK, to invoke IKJPARS. 


e FREEMAIN, to free main storage used as work areas. 





Reg 5‘ Points to PSWAREA. 4 
Reg 9 = Points to TCOMTAB. 


Exit Information 
C Output Parameters 


Return Codes 


Message CSECT 


Reg 12 Used as a base register. 


IKJEGPSW exits to IKJEGMNL via an SVC 3 instruction pointed to by Register 14. 


IKJEGPSW issues output lines to a terminal or a data set. 


0 Normal return. 
16 Attention interruption encountered during processing. 


20s STAE retry routine entered. 


IKJEGPWM is the message CSECT for IKJEGPSW. 


IKJEGQFY-QUALIFY Subcommand Processor 


Entry Information 


Input Parameters 


‘Se Function 


Data Areas 


Routines Called 


C 


Diagram 2.21 contains the method-of-operation information for this module. 


IKJEGQFY is entered from IKJEGMNL via a LINK macro instruction at entry point 
IKJEGQFY. 


IKJEGQFY receives the contents of the input buffer, and Register 9 points to 
TCOMTAB. 


IKJEGQFY updates the fields in TCOMTAB specified by the user. Fields that can 
be updated include: 


e PPTCB, which is the address of the current TCB. 

e PPLOAD, which is the loaded address of the currently qualified load module. 

e PPRB, which is the address of the current request block. 

e TSTCURLD, which is the EBCDIC name of the currently qualified load module. 


e TSTCURCT, which is the FRCDIC name of the currently qualified (SECT for 
the symbolic addresses. 


e TSTSYMBA, which is the base address for the symbolic addresses. 


Created: IKJEGQFY creates no data areas. 
Updated: IKJEGQFY updates TCOMTAB. 
Consulted: IKJEGQFY consults TCOMTAB. 


TSO: IKJEGQFY calls the following TSO routines: 

e IKJPARS, to check the syntax of the subcommand operands. 

e IKJEGCVT, to convert values to printable characters and to convert addresses. 
e IKJEGIO, to write data to a terminal or a data set. 


System: IKJEGQFY calls the following system routines: 
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- » LINK, to invoke IKJPARS. 


e STAE, to establish an abnormal termination exit. 


Register Usage during Module Execution 
Reg 9 =‘ Points to TCOMTAB. 





Reg 10 Points to the work area used by IKJEGQFY. 
Reg 12 Used as a base register. 


Exit Information 
IKJEGQFY exits via an SVC 3 instruction pointed to by Register 14. 


Output Parameters 
IKJEGQFY has no output parameters. 


Return Codes , 
0 Normal return. 
4 Qualification is to a new TCB; control returns to the problem program. 
16 Attention interruption encountered during processing. 
20‘ STAE retry routine entered. 


Message CSECT 
IKJEGMSG Is the message CSECT for IKJEGQFY. 


IKJEGSRH-SEARCH Mocdule 


Diagram 2.29 contains the method-of-operation information for this module. 





Entry Information 


IKJEGSRH is entered from a number of subcommand processors via a branch 
instruction. Subcommand processors using IKJEGSRH include the AT, COPY, OFF, 
and Assignment subcommand processors. 


Input Parameters 


Reg 1 contains a pointer to three words. The first word contains flags. The flag 

OO indicates to search for an address or range and delete the breakpoint 

elements. The flag 04 indicates to search for an address and return the address 

of the corresponding breakpoint queue element. The second word is an address 

of the two bytes containing the breakpoint or the start of a range. The third : 
word is the end of a range or zero. 


Function : 
When given an address or a range, IKJEGSRH searches the active breakpoint 
queue for a match or for an address within the range. If removal was indicated, 
the break element is removed from the queue and an attempt is made to restore 
the saved instruction into the problem program. 
If only search was indicated, the address of this element is returned to the caller. 
Data Areas 


Created: IKJEGSRH creates no data areas. 
Updated: IKJEGSRH updates the breakpoint element queue and TCOMTAB. ) 
Consulted: IKJEGSRH consults the breakpoint element queue and TCOMTAB. 
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Routines Called 
TSO: IKJEGSRH calls the following TSO routine: 
e The SVC 97 routine, to check the validity of an address. 
System: IKJEGSRH calls the following system routine: 


« FREEMAIN, to free queue elements being removed. 


Register Usage During Execution 
Reg 9 ~=— Points to TCOMTAB. 


Reg 8 Used as a base register for the break element queue. 


Reg 12 Used as a base register. 


Exit Information 
IKJEGSRH returns to the caller via a branch to the address in Register 14. 


Output Parameters 
When only search is indicated, IKJEGSRH returns the element address in the 
second word of the input parameter block. 


Return Codes 


Normal return. 
No elements found. 
8 Invalid range detected. 


12  STAE Retry routine invoked. 


Message CSECT 
IKJEGSRH has no message CSECT. 
( 


IKJEGSTA-STAE Exit Routine 


Diagram 2.31 contains the method-of-operation information for this module. 


Entry Information 
IKJEGSRH is entered from the ABEND/STAE Interface routine (IGCOBOIC). 


Input Parameters ; 


Reg | points to the work area if space was available. 
Reg 0 contains a X’12’ if no space was available for a work area. 


The fields TSTRETRY, ABENTAB, and ABENTAB! in TCOMTAB also contain input 
parameters and can be found from TEST’s TCB which has a pointer to TCOMTAB. 


Function 


IKJEGSTA determines the terminating TEST module and prints a standard 
first-level and second-level diagnostic message. The first level message contains . 
either the name of the terminating subcommand, or “‘TEST”’ if a resident TEST ; 
module is terminating. 


IKJEGSTA adds an error description to the second-level message. It gets the error 
description by using a table of predictable ABEND addresses to index a list of 
error descriptions in a message CSECT. 


IKJEGSTA obtains the name of the terminating subcommand. by examining the 
high order byte of the TSTRETRY field of TCOMTAB. If zero, a resident TEST 
module is terminating. If not zero, the field is used as a search argument for a 
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Data Areas 


Routines Called 


search of the module list CSECTs. Two module list CSECTs exist, one for IBM 
subcommands and one for user subcommands. The list for IBM subcommands is 
searched first. If a match is found in either list, IKJEGSTA places the found 
subcommand name in the first level message. 2 


IKJEGSTA obtains the address of the termination routine belonging to the 
terminating TEST module and passes the address to the ABEND/STAE Interface 
routine. The TSTRETRY field contains the address of the termination routine. 
Linkage is then established to the termination routine. 


Created: 1KJEGSTA creates no data areas. 

Updated: IKJEGSTA updates no data areas. 

Consulted: IKJEGSTA consults the following data areas: 
¢ The ABENTAB and ABENTABI fields in TCOMTAB are consulted. , 


« The TCB of TEST is used to get a pointer to TCOMTAB. It is also used to get 
the address of the request block. 


» The request block is used to find the PSW address associated with the ABEND 
condition. 


¢ Module List CSECTs are used to determine the name of the terminating 
subcommand. 


e The instruction counter table is used to determine the error description to be 
added to the standard second-level diagnostic message. 


TSO: IKJEGSTA calls the following TSO routine: } 
e IKJEGIO, to write data to a terminal or a data set. 


System: IKJEGSTA calls no system routines. 


Register Usage during Module Execution 


Exit Information 


Output Parameters 
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TSO Test 


Reg 1 Used as a parameter register when IKJEGSTA invokes the 1/0 routine, 
IKJEGIO; points to an output buffer from which diagnostic messages are 
issued. 


Reg 9 = Points to TCOMTAB. 
Reg 10 Points to a work area. 
Reg If Wsed as a base register. . 


Reg 14 Used as an internal link register. 


IKJEGSTA exits to the ABEND/STAE Interface routine via an SVC 3 instruction 
pointed to by Register 14. 


Reg 0 Contains the address of the retry routine to be given control by the 
ABEND /STAE Interface routine. 


Reg 1 Contains the address of the STAE work area, or zero if no work area 
was made available to IKJEGSTA by the ABEND/STAE Interface routine. 


Reg 14 Contains the return address set by the ABEND/STAE Interface routine. 


Reg 15 Contains a return code of four. This indicates that the ABEND/STAE 
Interface routine is to give control to a cleanup (retry) routine whose 
address is in Register 0. 


Return Codes 


Message CSECT 


4 Indicates that the ABEND/STAE Interface routine is to give control to a 
termination routine whose address is in Register 0. 


IKJEGMS|1 is the message CSECT for IKJEGSTA. 


IKJEGSYM-Symbol Module 


Entry Information 


Input Parameters 


Function 


Data Areas 


Routines Called 


Diagram 2.25 contains the method-of-operation information for this module. 
Figures 11 and 12 provide additional information. 


IKJEGSYM is entered from the Where, Qualify, or Convert modules. 


Register 1 points to a parameter descriptor entry (PDE) that contains: 


Loadname: (In PDELDNAM) Indicates request 
CSECT name: (In PDECTNAM) for symbol 

Symbol: (In PDEADRPT) information 
Loadname: (In PDELDNAM) Indicates request 
Offset: (In PDEADRPT) for CSECT name 
Loadname: (In PDELDNAM) Indicates request 
Entryname: (In PDECTNAM) for entry point address 


IKJEGSYM obtains symbol information by first searching the symbol table in 
memory built by the EQUATE subcommand. If this search fails, the assembler 
SYM records on the data set from which the specified module was fetched are 
searched. 


IKJEGSYM obtains a CSECT name or an entry point address by searching CESD 
records on auxiliary storage for a load module or CESD records in memory for an 
object module. 


Created: IKJEGSYM creates the symbol information block and the internal work 
area. 


Updated: IKJEGSYM updates the PDE and the internal work areas. 


Consulted: IKJEGSYM consults a contents directory entry, the extent list, 
TCOMTAB, symbol table elements in memory, the PDE, the SVC information 
block, SYM and CESD records on auxiliary memory, and CESD records in main 
memory. 


TSO: IKJEGSYM calls the following TSO routines: 
e IKJEGIO, to issue error messages to the terminal. 


¢ IKJDAIR, to allocate SYS1.LINKLIB if the problem program was fetched from 
that data set. 


System: IKJEGSYM Calls the following system routines: 


e GETMAIN, to allocate storage for the work area, symbol information block, 
and IKJDAIR parameter list. 


e FREEMAIN, to free the IKJDAIR parameter list and the STAE work area. 
*« OPEN, to open BPAM DCB to read SYM records. 
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CLOSE, to close BPAM DCB after reading SYM records. 
READ, to read SYM records. 


NOTE, to obtain the TTR of the first CESD record in the member associated 
with the load name. -@ 





FIND, to locate symbol records. 


SYMADAF, in case of an I/O error to get the system information message. 


SYNADRLS, to release the SYMADAF work area. 


Register Usage during Module Execution 
Reg 2  ~=Point to the address of the passed PDE. 


Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


Reg 8 Used as a base register for the message section. 


Reg 9 ~=Points to TCOMTAB. 


Reg 10 Used as a base register for the information block. 


Reg 11 Used as a base register for IKJEGMYS. 


Reg 12 Used as a base register for IKJEGSYM. 


Reg 13. Used as a base register for the SYM work area. 


IKJEGSYM returns control to the caller. 


The PDEUSER field of the PDE contains symbol information and the address of 
the entry name. The PDECTNAM field of the PDE points to the CSECT name in 


the work area. 





The return codes for this module follow. 


0 
4 


12 
16 


20 


Normal return. 


Input symbolic name is invalid. Either loadname, entryname, symbol, or 
insufficient memory causes this. 


Unable to resolve symbol at this time, cannot open DCB, or cannot allocate 
SYS1.LINKLIB. 


An 1/O error has occurred while reading a SYM record. 


An attention interruption occurred, or the LOGON/LOGOFE ECB issued a : 
POST macro instruction. 


An ABEND occurred and was intercepted by IKJFGSTA. 


IKJEGMSG is the message CSECT for IKJEGSYM. 


IKJEGTCB-LISTTCB Subcommand Processor 


Diagram 2.18 contains the method-of-operation information for this module. 


Entry Information 


Input Parameters 


176 


TSO Test 


IKJEGTCB is entered from IKJEGMNL at the entry point IKJEGTCB via a LINK 
macro instruction. 





IKJEGTCB receives the contents of the input buffer, and Register 9 points to 
TCOMTAB. 


Function 


Data Areas 


Routines Called 


IKJEGTCB lists the contents of a Task Control Block to a terminal or to a 
user-specified data set. To do this, IKJEGTCB performs the following functions: 


Issues a LINK macro instruction to IKJPARS to create a parameter descriptor 
entry for each TCB field requested by the user. 


Retrieves the data requested by the user. 
Converts data to printable hexadecimal and prints it. 


Returns control to IKJEGMNL. 


Created: IKJEGTCB creates its work area, MYWKAREA. 


Updated: IKJEGTCB updates no data areas. 


Consulted: IKJEGTCB consults TCOMTAB, the CVT, the TCB of TEST, and the 
TCB specified for the list function (default is to the subtask’s TCB). 


TSO: IKJEGTCB calls the following TSO routines: 


IKJPARS, to check the syntax of the subcommand operands. 
IKJEGCVT, to convert values to printable characters and to convert addresses. 
IKJEGIO, to write data to a terminal or a data set. 


IKJEGBLD, to build a character symbolic address. 


System: IKJEGTCB calls the following system routines: 


LINK, to invoke IKJPARS. 


e STAE, to establish an abnormal termination exit. 


FREEMAIN, to free the STAE work area. 


Register Usage during Module Execution 


Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


Reg 3 _—sCwPoints to the TCB being processed. 


Reg 5 Points to MYWKAREA. 


Reg 9 ~=— Points to TCOMTAB. 


Reg 12 Used as a base register. 


IKJEGTCB exits to IKJEGMNL via an SVC 3 instruction pointed to by Register 14. 


Output from IKJEGTCB consists of data issued to a terminal or to a data set. 


Return codes for this module follow. 


0 


Normal return. 


16 Attention interruption encountered during processing. 


20 


STAE retry routine entered. 


IKJEGMSG is the message CSECT for IKJEGTCB. 
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IKJEGWHR-WHERE Subcommand Processor 


Entry Information 


Input Parameters 


Function 


Data Areas 


Routines Called 


Diagram 2.23 contains the method-of-operation information for this module. 


IKJEGWHR is entered from IKJEGMNL at entry point IKJEGWHR via a LINK 
macro instruction. 


IKJEGWHR receives the contents of the input buffer, and Register 9 points to 
TCOMTAB. 


IKJEGWHR processes the WHERE subcommand of TEST. This processor obtains 
the absolute address either of a symbolic or a relative address in a problem 
program or the absolute address of an entry point in a load module or CSECT. 
IKJEGWHR also obtains the absolute address of the problem program 
interruption. 


Created: IKJEGWHR creates no data areas. 
Updated: IKJEGWHR updates no data areas. 
Consulted: IKJEGWHR consults TCOMTAB. 


TSO: IKJEGWHR calls the following TSO routines: 

« IKJPARS, to check the syntax of the subcommand operands. 

e IKJEGCVT, to convert values to printable characters and to convert addresses. 
e IKJEGIO, to write data to a terminal or a data set. 


e IKJEGSYM, to access a CSECT name in the indicated load module and to 
search the symbol table for a given load name CSECT. 


System: IKJEGWHR calls the following system routines: 
e LINK, to invoke IKJPARS. 
e STAE, to establish an abnormal termination exit. 


e FREEMAIN, to free main storage used as work areas. 


Register Usage during Module Execution 


Exit Information 


Output Parameters 


Return Codes 


Message CSECT 


178 TSO Test 


Reg 9 = Points to TCOMTAB. 


Reg 12 Used as a base register. 


IKJEGWHR exits to IKSJEGMNL via a branch to the address in Register 14. 


Output from IKJEGWHR consists of lines written to a terminal. 


4 Normal return. 
16 Attention interruption encountered during processing. 


20 ‘STAE retry routine entered. 


IKJEGWHR has no message CSECT. 


J 


J 





C 


Section 4: Directory 


This section contains an alphamerically organized list of entry names and CSECT 
names. Each name is defined and cross-referenced to its assembly module and 
load module. 


Module Cross Reference Directory 












Assembly Modules 
That Refer to Entry 
Name or CSECT 

Name 


Definition of Entry 
Name, CSECT 
Name, or 
Associated Code 














Entry Name 
or 
CSECT Name 


Assembly 
Module 





















ADDRCHK IKJEGGO IKJEGGO 





IKJPARS Validity check exit 


routine. 
































IGCOO06A IGCOOO6A 











IGCOOO6A IKJEGMNL Major entry point of 
Contents Supervision |SVC 61 routine. 
(IEAQLKOO) 

















IGCO009G IGCO009G IGCOOO09G_Ss| Any module of TEST, Major entry point of 
when SVC 97 routine is |SVC 97 routine. 
used as a service 
subroutine. Any module 
of tested program. 


IKJEGAPL IKJEGAT IKJEGAT IKJPARS 


IKJEGASN IKJEGASN IKJEGASN 


IKJEGAT IKJEGAT IKJEGAT 


IKJEGATD IKJEGATD IKJEGATD 


IKJEGATM IKJEGAT IKJEGAT IKJEGMNL 
IKJEGATN IKJEGATN IKJEGATN IKJEARO5 
(Attention Handler in 
region control task) 
| IKJEGCAL IKJEGGO IKJEGGO IKJEGMNL 
IKJEGSCD 
IKJEGCDL IKJEGCVT IKJEGMNL IKJEGCVT 


IKJEGCOP IKJEGCVT IKJEGMNL IKJEGCVT 








Parameter control 
list CSECT. 


Major CSECT of 
second load module 
of Assignment 
subcommand 
processor. Is 
entered from 
IKJEGPCH by an 
XCTL macro 
instruction. 


Major CSECT of 
module IKJEGAT. 
Sets active 
breakpoints in 
problem program. 


Major CSECT of 
module IKJEGATD. 
Receives control 
from module 
IKJEGAT, via an 
XCTL macro 
instruction, to set 
deferred 
breakpoints. 


Message CSECT of 
module IKJEGAT. 


Major CSECT of 
module IKJEGATN. 























IKJEGSCD 
IKJEGMNL 












IKJEGMNL 
IKJGGSCD 






IKJEGAT 


































Entry point of the 
CALL subcommand 
processor. 


Contains list of valid 
two-byte OP codes. 
ls used for validity 

checking. 









Contains list of valid 
OP codes. Is used 

for validity checking. 
One byte. 
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IKJEGCVX 























Assembly Modules 
That Refer to Entry 
Name or CSECT 

Name 


Definition of Entry 
Name, CSECT 
Name, or 
Associated Code 


Assembly Load 
Module Module 
Name Name 










CSECT Name 


IKJEGCPY 


IKJEGCVT 






















IKJEGCPY 





IKJEGCPY 






IKJEGMNL 
IKJEGSCD 


Major entry point 
for the COPY 
subcommand 
processor. 














IKJEGCVT IKJEGMNL 





IKJEGMNL 
IKJEGSCD 


Major entry point of 
module IKJEGCVT. 
Converts addresses 
to binary and 
printable characters. 
Converts values to 
printable and binary 
format. 


CSECT in module 
IKJEGCVT. 
Converts 
instructions to 
printable characters. 


IKJEGWHR Contains external 
character data used 
to build a data 
message. 














IKJEGCVT IKJEGMNL IKJEGCVT 









IKJEGDA1 IKJEGWHR | IKJEGWHR 





IKJEGWHR 


IKJEGWHR Contains external 
character data used 
to build a data 
message. 


IKJEGWHR Contains external 
character data used 
to build a data 
message 


IKJEGWHR Contains external 
character data used 
to build a data 
message. 


IKJEGDA2 IKJEGWHR 


IKJEGDA3 
IKJEGDA4 





IKJEGWHR | IKJEGWHR 








IKJEGWHR | IKJEGWHR 

















IKJEGDBM {KJEGDEB IKJEGDEB IKJEGDEB Message CSECT. 
IKJEGDBP IKJEGDEB IKJEGDEB IKJPARS Parameter control 
list CSECT. 
















IKJEGDCB 





IKJEGDCB IKJEGDCB IKJEGMNL 


IKJEGSCD 


Major entry point of 
LISTDCB 
subcommand 
processor. 
























ees 


IKJEGDDM 


IKJEGDEB 
IKJEGDEL 


IKJEGDLT IKJEGLDF IKJEGLDF IKJPARS 


IKJEGMNL 









IKJEGIO 





















IKJEGMNL CSECT used to 
IKJEGINT create diagnostic 
IKJEGLDF messages after an 
IKJEGIO unseccessful return 








from IKJIDAIR. 







IKJEGDEB 





IKJEGMNL 
IKJEGSCD 







IKJEGDEB Major entry point of 
LISTDEB 
subcommand 


processor. 












IKJEGLDF 





IKJEGLDF IKJEGMNL 


IKJEGSCD 


Entry point of 
DELETE 

subcommand 
processor. 














Parameter control 
list CSECT for 
DELETE 
subcommand 
processor. 














J 
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Assembly Modules Definition of Entry 































Entry Name Assembly That Refer to Entry Name, CSECT 
or Module Name or CSECT Name, or 
CSECT Name Name Name Associated Code 

























IKJEGDMG IKJEGIO IKJEGMNL IKJEGMNL Message CSECT. 
IKJEGDRP IKJEGEQU IKJEGEQU IKJEGMNL Entry point of the 
IKJEGSCD DROP subcommand 


processor. 





IKJEGDCB IKJPARS Validity check 


routine. 


IKJEGDVK IKJEGDCB 






























IKJEGEND IKJEGEND IKJEGEND IKJEGMNL Entry point for the 
IKJEGSCD END subcommand 
processor. 
IKJEGEQU IKJEGEQU IKJEGMNL Entry point of 
IKJEGSCD EQUATE 
subcommand 
processor. 
IKJEGFLT IKJEGCVT IKJEGMNL IKJEGCVT Converts floating 
point data to and 
7 from binary. 
IKJEGFM IKJEGCPY iKJEGCPY IKJIPARS Entry point for the 
IKJEGCVT validity check 


routine that tests 
the “from” address 
(address1) in the 
COPY subcommand 
processor. 


IKJEGMNL Entry point of 
IKJEGSCD FREEMAIN 
subcommand 
processor. 


IKJEGLDF IKJPARS Parameter contro! 
list CSECT for 
FREEMAIN 
subcommand. 

















IKJEGLDF 








IKJEGFRE IKJEGLDF 





IKJEGFRL 





IKJEGLDF 















IKJEGLDF 





IKJEGGET IKJEGLDF IKJEGMNL 








Entry point of the 
GETMAIN 
subcommand 
processor. 
IKJEGGO IKJEGMNL Entry point of the 
IKJEGSCD GO subcommand 


processor. 





IKJEGMNL Any TEST module, 
except IKJEGATN 


IKJEGGT IKJEGIO 





Entry point to 
obtain input from 
the terminal for any 
TEST module except 
IKJEGATN 








IKJEGGTM 


IKJEGLDF IKJPARS 


IKJEGINT | IKJEFTO2 


(TMP Mainline) TEST Initialization 
1GCOOC0SG module. 


IKJEGIO IKJEGIO IKJEGMNL IKJEGMNL Major entry point of 
1/0 module of 
ae eee 
IKJEGLDF IKJEGLDF IKJEGLDF IKJEGMNL Major CSECT of 
IKJEGSCD module IKJEGLDF. 


IKJEGLDP IKJEGLDF IKJEGLDF IKJPARS Parameter control 
list CSECT for 
LOAD 
subcommand. 
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IKJEGLDF Parameter control 


list subcommand. 












IKJEGINT IKJEGINT Major entry point of 














Module Cross Reference Directory 


















Load 
Module 
Name 


Entry Name 
or 
CSECT Name 


IKJEGLDR IKJEGLDR 


Assembly 
Module 
Name 








IKJEGLDR 


Assembly Modules 
That Refer to Entry 
Name or CSECT 
Name 








Definition of Entry 
Name, CSECT 
Name, or 
Associated Code 













IKJEGINT Major entry point of 


module IKJEGLDR. 






















IKJEGLN IKJEGCPY IKJEGCPY 








IKJEGLOD IKJEGLDF IKJEGLDF 


IKJEGLSA IKJEGLSA IKJEGLSA 


IKJEGLST IKJEGLST 


IKJEGMAP IKJEGMAP IKJEGMAP 









INJEGLST 













IKJPARS 
IKJEGCVT 


Entry point of the 
validity check 
routine that tests 
the LENGTH 
keyword of the 
COPY subcommand. 


Entry point of LOAD 
subcommand 
processor. 





















IKJEGMNL 
IKJEGSCD 
























IKJEGMGC 
IKJEGMNL 


IKJEGCPY 
IKJEGMNL 


IKJEGCPY 
IKJEGMNL 





IKJEGMSA 
IKJEGMSA 
IKJEGMSA 


IKJEGLDF 
IKJEGLST 
IKJEGOFF 


IKJEGLDF 
IKJEGLST 
IKJEGOFF 





IKJEGMSB 
IKJEGMSB 









IKJEGLDF IKJEGLDF 













IKJEGMSC IKJEGLDF IKJEGLDF 





IKJEGMSC IKJEGPCH IKJEGPCH 


IKJEGMSD IKJEGASN IKJEGASN 









IKJEGLSA IKJEGLSA 


























IKJEGSCD Major entry point of 
IKJEGMNL second load module 
IKJEGLST of LIST | 
subcommand 
processor. 
IKJEGSC Major entry point of 
IKJEGMNL first load module of 
IKJEGLSA LIST subcommand 
processor. 
IKJEGMNL Major entry point of 
IKJEGSCD LISTMAP 
subcommand 
processor. 
IKJEGCPY Message CSECT. 
IKJEGINT Major entry point of 
TEST IKJEGMNL 
module. 
IKJEGLDF Message CSECT. 
IKJEGLST Message CSECT. 
IKJEGOFF Entry name in 
message CSECT in 
module IKJEGOFF. 
IKJEGLSA Message CSECT. 


















IKJEGMNL Entry name in 
IKJPARS message CSECT in 
IKJDAIR module IKJEGLDF. 
IKJDFLT eee 
IKJEGLDF Entry name in 


message CSECT in 
{module IKJEGLDF. 








Message CSECT. 





IKJEGASN 


IKJEGMSD IKJEGLDF IKJEGLDF IKJEGLDF Message CSECT in 
module IKJEGLDF. 








IKJEGMSE IKJEGLDF IKJEGLDF 
IKJEGMSF IKJEGLDF IKJEGLDF 





IKJEGLDF Entry name in 
message CSECT in 


module IKJEGLDF. 


Entry name in 
message CSECT. 











IKJEGLDF 


IKJEGMSG IKJEGGO IKJEGGO IKJEGGO Message CSECT. 
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Viodule Cross Reference Directory 


Assembly Modules Definition of Entry 
Entry Name Assembly That Refer to Entry Name, CSECT 


or Module Name or CSECT Name, or 
CSECT Name Name Name Associated Code 


Message CSECT. 
IKJEGEQU | _IKJEGEQU _|Message CSECT. _ 
IKJEGLDF IKJEGLDF Message CSECT. 

















Message CSECT. 


IKJEGMSG IKJEGOFF IKJEGOFF IKJEGOFF Message CSECT. 
IKJEGMSG IKJEGTCB IKJEGTCB IKJEGTCB Message CSECT. 


IKJEGMSG IKJEGWHR | IKJEGWHR Message CSECT. 


IKJEGMSH IKJEGLDF IKJEGLDF Entry name in 


message CSECT. 
IKJEGMSJ 


Entry name in 
message CSECT. 


IKJEGLDF 










































IKJEGLDF 





IKJEGLDF IKJEGLDF 
























IKJEGMSK IKJEGLDF 


IKJEGMSL 
IKJEGMSM 
message CSECT. 
IKJEGMSN IKJEGLDF Entry name in 
message CSECT. 
IKJEGMSO IKJEGLDF IKJEGLDF Entry name in 
message CSECT. 
IKJEGMSP IKJEGLDF IKJEGLDF IKJEGLDF Entry name in 
message CSECT. 
IKJEGMSQ IKJEGLDF IKJEGLDF IKJEGLDF Entry name in 
| message CSECT. 


IKJEGQFY IKJEGQFY IKJEGQFY Message CSECT. 
IKJEGMSR 


IKJEGLDF IKJDGLDF IKJEGLDF 
IKJEGMSS 


IKJEGMSX 


IKJEGLDF IKJEGLDF Entry name in 


message CSECT. 


















IKJEGLDF IKJEGLDF IKJEGLDF Entry name in 


message CSECT. 


Entry name in 












IKJEGLDF 








IKJEGLDF IKJEGLDF 










IKJEGLDF IKJEGLDF 






IKJEGLDF 























Entry name in 
message CSECT. 
















a ie Ane 


IKJEGLDF IKJEGLDF 





IKJEGLDF 





Entry name in 
message CSECT. 























iIKJEGLDF IKJEGLDF IKJEGLDF Entry name in 


message CSECT. 
Message CSECT. 










_IKJEGMS1 
IKJEGMS4 







IKJEGSTA _ 
IKJEGWHR 


: IKJEG MNL | 





IKJEGWHR 










Entry name in 


IKJEGWHR 
message CSECT. 
Entry name in 


IKJEGMS7 IKJEGWHR IKJEGWHR 
message CSECT. 
IKJEGMS8 IKJEGWHR | IKJEGWHR IKJEGWHR Entry name in 
message CSECT. 
IKJEGMS9 IKJEGWHR IKJEGWHR IKJEGWHR Entry name in 
message CSECT. 
IKJEGMYS IKJEGSYM IKJEGSYM IKJEGSYM Second executable 
CSECT. 








IKJEGWHR 
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Assembly Modules Definition of Entry 
Entry Name Assembly That Refer to Entry Name, CSECT 


or Module Name or CSECT Name, or 
CSECT Name Name Name Associated Code 




























IKJEGM2 IKJEGATD IKJEGATD IKJEGATD Message CSECT. 
IKJEGLDF IKJEGLDF IKJEGLDF IKJEGMNL Major CSECT name. 
IKJEGLDF 












Major entry point of 
the OFF 
subcommand 
processor. 


IKJEGOFF IKJEGOFF IKJEGOFF IKJEGMNL 
IKJEGSCD 


IKJEGEND 






Parameter control 
list CSECT that 
describes the format 
of the parameters, 
for GO and RUN 
subcommands. 


IKJEGPAR IKJEGGO IKJEGGO IKJPARS 


IKJEGEQU 


IKJEGEQU IKJPARS 


IKJEGPAR Parameter control 
list CSECT that 
describes the format 
of the parameters, 
for the EQUATE 


subcommand. 


IKJEGGO IKJPARS Parameter control 
list CSECT that 
defines the format 
of the CALL 
parameters. 


Major CSECT of 
first load module of 
Assignment 
subcommand 
processor. 








IKJEGPAS IKJEGGO 


IKJEGPCH 
IKJEGPCL 








IKJEGPCH IKJEGPCH IKJEGSCD 


IKJEGMNL 













IKJEGDCB IKJEGDCB IKJPARS Parameter control 
list CSECT that 
describes the format 
of the LISTDCB 


parameters. 















IKJEGTCB IKJEGTCB IKJPARS Parameter control 
list CSECT that 
describes the format 
of the LISTDCB 


parameters. 









IKJEGPCL 


IKJEGPCL 








IKJEGMAP 


IKJEGMAP IKJPARS Parameter control 


list CSECT that 







of the LISTMAP 
parameters. 





IKJEGPCL IKJEGOFF IKJEGOFF IKJPARS Parameter control 


list CSECT that 
describes the format 
of the OFF 
parameters. 





describes the format | 





IKJEGPCL IKJEGQFY IKJEGQFY IKJIPARS Parameter control 
list CSECT that 
describes the format 
of the QUALIFY 
parameters. 








Module Cross Reference Directory 

















Assembly Modules 
That Refer to Entry 
Name or CSECT 

CSECT Name Name 


IKJEGPCL IKJEGTCB IKJEGTCB IKJPARS 
IKJEGPG IKJEGIO IKJEGMNL Any TEST module 


except IKJEGATN 
IKJEGPMA IKJEGLST IKJEGLST 


IKJEGPMB 


Definition of Entry 
Name, CSECT 
Name, or 
Associated Code 















Entry Name 
or 


Assembly 
Module 
Name 















Parameter control 
list that describes 
the format of the 
LISTTCB 
parameters. 






One of three entry 
points to module 
IKJEGIO. This entry 
point is used to 
issue a PUTGET 
macro instruction to 
solicit input from 
the terminal. 














IKJPARS Parameter control 
list CSECT that 
describes the format 
of the LIST 


paramaters. 

















IKJEGPCH IKJPARS Parameter control 
list CSECT that 
describes the format 
of the Assignment 


parameters. 


IKJPARS 





IKJEGPRM IKJEGCPY 


IKJEGPRS 
IKJEGPRS 


IKJEGPSW 


IKJEGCPY 





Parameter control 
list CSECT for the 
COPY subcommand 
processor. 



















IKJEGEQU IKJEGEQU IKJPARS Parameter control 
list CSECT that 
describes the format 
of the DROP 


parameters. 











IKJEGWHR IKJEGWHR IKJPARS Parameter control 
list CSECT that 
describes the format 
of the WHERE 


parameters. 



















IKJEGPSW IKJEGPSW 






IKJEGMNL 
IKJEGSCD 


Major entry point 
for the LISTPSW 
subcommand. 












IKJEGMNL 














IKJEGPT IKJEGIO 


One of three entry 
points to module 
IKJEGIO. This entry 
point is used to 
issue Output to the 
terminal or to a 


print data set. 
Message CSECT. 


Any TEST module 
except IKJEGATN. 























IKJEGMNL 
IKJPARS 


IKJEGPWM IKJEGPSW IKJEGPSW 
IKJEGCVT 


IKJEGPWP IKJEGPSW IKJEGPSW IKJPARS 


IKJEGQFY IKJEGQFY IKJEGQFY IKJEGMNL 





Parameter control 
list CSECT that 
describes the format 
of the LISTPSW 
parameters. 















Major entry point 
for QUALIFY 
subcommand. 


IKJEGSCD 
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IKJEGSCD 











Assembly Modules 

















Definition of Entry 








































Entry Name | Assembly Load That Refer to Entry Name, CSECT 
or Module Module Name or CSECT Name, or 
CSECT Name Name Name Name Associated Code 
IKJEGRUN IKJEGGO IKJEGGO IKJEGMNL Major entry point 
IKJEGSCD for RUN 
subcommand. 
IKJEGSCD IKJEGSCD IKJEGINT Entry name of 














IKJEGMNL 
IKJEGSTA 


subcommand name 
table. This table 
contains the valid 
subcommand names 
and their associated 
IDs, and the 
suffixes for most 
load module names. 


Message CSECT. 











IKJEGSYM 


IKJEGSMG IKJEGSYM 


IKJEGSYM 




















































IKJEGSRH tKJEGSRH IKJEGSRH IKJEGOFF Entry point for the 
IKJEGAT Search module. 
IKJEGASN 
IKJEGSTA IKJEGSTA IKJEGMNL IKJEGMNL Major entry point of 
ABEND/STAE STAE Exit routine of 
Interface TEST. 
(IGCOBO1C) 
IKJEGSYM IKJEGSYM IKJEGSYM | IKJEGCVT Major entry point of 
IKJEGWHR Symbol module of 
IKJEGOFY TEST. 






IKJEGTCB IKJEGMNL 
IKJEGSED 


Major entry point 
for the LISTTCB 
subcommand. 


IKJEGTCB IKJEGTCB 


IKJEGTO IKJEGCPY 


IKJEGVCK 


IKJEGVCK 



























IKJEGCPY IKJPARS 


IKJEGCVT 


Entry point for the 
validity check 
routine that tests 
the ‘‘to’’address 
(address2) in the 
COPY subcommand 
processor. 














IKJEGOFF 


rarer aataaimeneammene’ 


IKJPARS 








IKJEGOFF Validity check exit 
for the OFF 


subcommand. 









IKJEGTCB IKJEGTCB IKJPARS 

















IKJEGVOK 


Laatste mieten 


IKJEGEQU 


IKJEGEQU 
IKJEGWHR IKJIEGWHR IKJEGWHR 
subcommand 
| processor. 


IKJEGXDR IKJEGLDR IKJEGLDR IKJEGLDR Message CSECT. 
IKJEGXNL IKJEGMNL IKJEGMNL | IKJEGMNL Message CSECT. 
IKJEGXNT IKJEGINT IKJEGINT IKJEGINT Message CSECT. 


IKJPARS 

























IKJEGMNL 
IKJEGSCD 






Major CSECT name 
for the WHERE 





IKJEGYDR IKJEGLDR IKJEGLDR IKJEGLDR Parameter control 
list CSECT. 


IKJEGYNT IKJEGINT IKJEGINT IKJPARS 







Parameter control 
list CSECT for TEST 
command before 
IKJEGMNL receives 
control. 


IOMSGCST | IKJEGIO IKJEGMNL IKJEGIO Message CSECT. 


a 


C 
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Break Element Queue 


This section contains information about the following control blocks, work areas, 


and tables built and used by the TEST command processor. 


The AT subcommand processor (IKJEGAT) builds a break element for each 
address specified by the user in an AT subcommand. The queue of break 


Break element queue. 

Break element. 

Defer element queue. 

Defer module element. 

Defer break element. 

IKJPARMA. 

Entry for symbol table built in storage. 
Subcommand Name Table (IKJEGSCD). 
SVC Information Block. 

Symbol! information block. 

TEST Communication Table (TCOMTAB). 


TEST’s work area (TSTCWORK). 


elements is chained from the BREAKTAB field of TCOMTAB. Many test modules 
(the SVC 97 routine, IKJEGGO, IKJEGMNL, IKJEGQFY, IKJEGASN, and IKJEGLST, 
for example) refer to the break element queue. 
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BREAKTAB (In TCOMTAB) 
Address of 


Break Element 
Queye 





BRKLINK 


Address 
of Next 
Break 


Element. 


Address 
of Next 
Break 
Element, 


BRKADDR 


Addeess of 
Origiaal 
Instruction 


in Tested 


Program, 


IKJEGOFF purges break elements from the queue either because the user has 
entered am OFF subcommand or because IKJEGMNL linked to IKJEGOFF during 
END or RUN processing. Figure 14 shows a break element queue. 


Preece eee 


Original Igstruction in 
(Padded with NQ OP; 
fo six bytes ) 





SVC 97 
finstr, 


BRKDISP BRKNAME 


Displace- 
ment 
from First 


Address of First 
Address Entered 
by User, 


Address 
ate Ronge 


1 Lengr® of | 
Address First Addsess Entered by User. 


0 


2 


Length of 
Subcommand Chain, 00 


Q 


Address of . 


Originol 
lastcuctiog 
in Tested 
Program . 


2 


Original Instruction in 
Tested Program. 


(Padded with NO OPs 
to sin bytes } 


Figure 14. Break Element Queue 
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14 


SVC 97 


Instr, 


16 


17 


paasasay 


Displace- 
ment 

from First 
Address 
of Range 


18 20 


Address of First 
Address Entered 


by User, 


BRKCHAIN 


24 


Address of 


Subcommand 


Chain 





Address of 
Subcomman 


Chain 





BRKCOUNT 


Count Count 


30 


Legend: 


[Sr Pointer 





| 
28 30 32 





BRKRB 


Address of 
Tested Program 


RB or O 


Address of 
Tested Program 


RB or 0 








Dec. Disp. 


BRKFLGS 
X'80' 
X'40' 
X'20' 
X'10' 


Contents of 


Before 


Figure 15 shows an example of a break element. 


Entered at terminal : 


at +8: 1a (GO) COUNT (2) 


BRKELEM for +A 


BRK LINK 
00 


BRKADDR 


+0 


+4 


+8 
BRKINST 


38 





+16 






BRKFLAGS 
40 





BRKDISP 
00 


Reserved 
00 














+20 
BRK NAME 


+24 
BRKCHAIN 


00 


BRKCOUNT 
00 


+28 


+32 


BRKRB 


= BALSW 

= BRKRANGE 
= BRKLIST 

= BRKNONOT 


main storage before and after breakpoint processing: 


OF IE8 SFIES8 
After 
SFIEA 


+8 05C0 +8 0A61 


SFIEA +A 58A0C 400 tA 


Figure 15. Break Element Example 


0A61C 400 


Pointer to next break element on the chain, 
or O's if this is the last break element. 


Address of the Problem Program Instruction at 
which the breakpoint SVC represented by 
this break element is set. 


Field containing the instruction at which the 
breakpoint is set. Padded with NOP's if 
this instruction is smaller than six bytes. 
Low-order two bytes: SVC 97 instruction. 


Hexadecimal displacement of the breakpoint 
from the beginning address of a range. 


Address of first EBCDIC address entered by 
the user. 


The address of the EBCDIC command chain 
entered in the AT subcommand which caused 
this break element to be built. 


Low-order two bytes: Count specified in 
the AT subcommand which caused this break 
element to be built. 


Address of RB for the module in which this 


breakpoint was encountered. Zero before 
breakpoint is first encountered. 


CO1A0 
| oz [es 
CO1B8 
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Break Element 


The macro name of the element is BRKELEM. 


Dec. Hex. Field Referenced |Cleared J 
Disp. foe Field Name | Size (Contents Set by by by 


BRKLINK Link field. Pointer IKJEGAT SVC 97 
to next break IKJEGGO 
element on chain IKJEGMNL 
| (or is zero if it is IKJEGLSA 
the last break IKJEGLST 
element). IKJEGASN 
IKJEGOFF 
IKJEGQFY 
IKJEGCPY = 


The absolute IKJEGAT |IKJEGMNL 
address in SVC 97 
























































IKJEGAT, the IKJEGOFF ' 
problem program IKJEGLST 
at which the IKJEGPCH 


breakpoint (SVC 
97) represented 
by this break 

element is set. 


IKJEGGO 

IKJEGCPY 
IKJEGQFY 
IKJEGLSA 
IKJEGASN 





8 Field containing |IKJEGAT |SVC 97 
the instruction at IKJEGLST 
whose SVC is IKJEGOFF 
set. The last two IKJEGMNL 
bytes of the field IKJEGQFY 
contain a 
breakpoint SVC 





instruction. Any 
remaining space 
between this SVC 
and the saved 
instruction at the 
beginning of this 
field contains 
NOPs. 


The following are 
possible values 
for BRKFLGS: 
Indicates that the 
saved instruction 
is a BAL ora 
BALR. 

BRKRANGE : Indicates that this 
break element is 
one of a range of 
addresses. 

BRKLIST Indicates that the 
break element is 
one of a list of 
addresses. 

BRKNONOT Indicates that no 
notification to the 
terminal is to be 
written when the 
breakpoint 
represented by 
this element is 
encountered. 

... .Xxxx |Reserved. 
7 [at | 


| | 1 [Reserved space. | | sd 
BRKDISP 


IKJEGAT |IKJEGMNL 
J 





IKJEGAT |SVC 97 






IKJEGAT |IKJEGOFF 
IKJEGMNL 





IKJEGAT |IKJEGOFF ° 









IKJEGAT |IKJEGMNL 













Binary 
(hexadecimal) 
displacement of 
the breakpoint 
from the 
beginning address 
of a range of 
addresses. 
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Dec. | Hex. Field Referenced (Cleared 
Disp. |Disp.| Field Name | Size |Contents by by 


Points to the first |IKJEGAT |IKJEGOFF 
IKJEGMNL 














































EBCDIC address 
(or only one, if 
not a range) 
entered by the 
user when the AT 
subcommand 
caused this break 
element to be 
built. 


7 - 
BRKCHAIN 
built. 


1C |BRKCOUNT The low order IKJEGAT {SVC 97 
two bytes of this |SVC 97 
field contain the 
count (minus one) 
specified in the 
AT subcommand 
that caused this 
break element to 
be built. 

Both the low 
order two bytes 
and the high 
order two bytes 
are set to this 
count value by 
IKJEGAT. This 
high order two 
bytes are 
decremented by 
the SVC 97 
routine until the 
value reaches 
zero, at which 
time the SVC 97 
routine resets the 
high order two 
bytes to the value 
of the low order 
two bytes. 
A breakpoint is 
actually taken 
only when the 
high order two 
bytes equal zero. 
BRKRB Address of RB SVC 97 IKJEGOFF 
for the SVC 97 
module in which 
the breakpoint 
represented by 
this break 
element was 
encountered. 
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The address of 
the EBCDIC 
subcommand 
chain entered in 
the AT 
subcommand that 
caused this break 
element to be 


IKJEGAT = |IKJEGOFF 
IKJEGMNL 
IKJEGIO 



















Defer Element Queue 


Figure 16 shows a defer element queue. The defer element queue consists of one 
or more defer module elements and associated defer break elements. The 
elements are built by module IKJEGATD and are queued from the DEFERTAB 
field of TCOMTAB, when the user issues an AT DEFER subcommand. The 

elements point to information that describes one or more breakpoints in a 
module of the problem program. When the module is loaded, IKJEGMNL links to 
module IKJEGAT to build break elements and set breakpoints in the specified 
module. 











DEFERTAB 












Address of 
First Defer 
Module Element 


4 Bytes 


Defer Module Element (DME) 












Address of 
First OBE 
for this 

Load Name 








Address of 
next DME 





Load Name 


8 Bytes 


Defer Greak Element (8DE) 












Address of 
PDL 


Address of 
Next DBE 
















Address of 
Input 
Buffer 


4 Bytes 


Address of 
Input 
Buffer 






Address of 
PDL 





Address of 
First DBE 
for this 

Load Name 









Load Name 





Address of 
Input 





Address of 
PDL 





Figure 16. Defer Element Queue 
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Defer Module Element (DME) 


Defer module elements and defer break elements are removed from the queue by 
module IKJEGOFF. This occurs when the user eneters an OFF subcommand, or 
( when IKJEGMNL prepares to return to the TMP. 


Dec. | Hex. Field Referenced /|Cleared 
Disp. |Disp.| Field Name | Size Set by by by 


Pointer to the IKJEGATD |IKJEGAT IKJEGOFF 
next DME or IKJEGOFF 
contains zeros, if 
no more defer 
module elements 
exist. 
Pointer to the IKJEGATD |IKJEGAT IKJEGOFF 
first defer break IKJEGOFF 
element. 


Name of load IKJEGATD |IKJEGAT IKJEGOFF 
module in which IKJEGOFF 

breakpoints are to 

be set. 





Defer Break Element (DBE) 


Dec. | Hex. Field Referenced (Cleared 
Disp. | Disp.| Field Name | Size Set by by by 
DBEDBE Pointer to the IKJEGATD |IKJEGAT IKJEGOFF 
next defer break IKJEGOFF 
element, or 
contains zeros, if 
no more break 
elements exist. 
DBEPDL Pointer to the IKJEGATD |IKJEGAT IKJEGOFF 
parameter IKJEGOFF 
ay - 4 


































descriptor list 
that describes the 
operand of the 
AT DEFER 
subcommand. 




























IKJEGATD |IKJEGAT 


IKJEGOFF 


Pointer to the 
input buffer that 
contains the AT 
DEFER 
subcommand. 


IKJEGOFF 
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IKJIPARMA 


The IKJPARS address PDE described by this control block is dependent upon the 
PDE definition made by IKJPARS. 


Dec. | Hex. Field Referenced |Cleared 
Disp. |Disp.| Field Name | Size Set by by by 
0 


PDELDNAM 4 Pointer to load 






















































name. 
4 PDELEN1 2 Length of load 
name. 
6 6 |PDEFLG1 1 Flags for load 
LDNAMFLG name. 
Waaeis Load name ips 
present. 
.XXXXXXx! Reserved. 
7 7 |PDERSV1 1 Reserved 
PDECTNAM 4 Pointer to entry 
' name. 
12 C |PDELEN2 2 Length of entry 
name. 
PDEFLG2 1 Flag for entry 
CTNAMFLG name. 
i Peery Entry name 
present. 
-XXAXAXK Reserved bits. 
YF | PDERSV2 1 Reserved. 
PDEADRPT 4 Pointer to 
address string. 
PDELEN3 2 Length of address 
string. 
| PDEFLG3 1 Flag for address S) 
AFLG eee string. 
.xxxxxx |Address present. 
Reserved. 
| 23 | 17 |poersv3 | 1. [Reserved 
PDEFLG4 1 anes for address 
ADSADDR Osan Absolute address. 
SYMADDR 1 : 
seinen Symbolic address. 
RELADDR 1 Relativeada 
GENR i Perea elative address. 
LFPR a Pere General register. 
...1..... |Double precision 
SFPR floating point 
register. 
CTONLY pee Ie Single precision 
floating point » 
register. 
hueite 1.. |Entry name is not 
followed by 
symbolic or e 
relative address. 
nhiyad xx_| Reserved. 
| 25 | 19 PDESIGN 1 Expression sign. fo 
| 26 | 1A | PDEINDCT 2 Indirect count. P| 
1C |PDEEXPTR Pointer to first 
expression PDE. 
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Referenced /|Cleared 
Contents by by 


Flag for 

PDEUSER field. 
PDEUSER points 
to SIB. 

Address is 
converted. 

PDE is one of a list. 
PDE is useless 
Address is 


Dec. | Hex. 
Disp. | Disp.| Field Name 
writeable. 


PDEFLG5 
PDESIB 
PDECONVD 
PDEADLST 
PDEYECH 
PDEWRITE 
Reserved. 


PDEUSER 3 Resolved address 
or pointer to SIB. 


PDECHAIN Chain pointer 
filed for address 
list. 

This is the 
overlay for the 
address range. 


PDE2LDNA Pointer to load 
name. 
28 |PDE2LEN1 Length of load 
name. 


2A |PDE2FLG1 Flags for load 
LDNAMFLG 


name. 
Load name 

PDE2RSV1 

PDE2CTNA 


present. 
PDE2LEN2 


Reserved. 
PDE2FLG2 


CTNAMFLG 


Pointer to entry 
name 
Length of entry 
name. 
PDE2RSV2 aa 


Flags for entry 
PDE2LEN3 a 


Field 
Size 
1 















































































name. 
Entry name 
present. 














Pointer to 
address string. 
















Length of address 
String. 





Flag for address 
string. 

Address string 
present. 
Reserved. 


Reserved. 
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Dec. | Hex. Field Referenced /|Cleared 
4 Disp. |Disp.| Field Name | Size |Contents by by 


F 3c _|PDEZFLG4 


Kl ic 

PDESIB=—s_|,_ 1... 
PDECONVD | 1....... 
PDEADLST 
PDEYECH 
PDEWRITE oe ee 


PDE2CHAI a pointer 























Flags for address 
type. 

Absolute address. 
Symbolic address. 
Relative address. 
General register. 
Double precision 
floating-point 
register. 

Single precision 
floating-point 
register. 

Entry name is not 
followed by 
symbolic or 
relative address. 
Reserved. 





Pointer to first 
expression PDE. 





















field for address 








c 


Entry for Symbol Table Built in Storage 


This table contains elements that are built and chained by the EQUATE 
subcommand. These elements are unchained and freed by the DROP 
subcommand. This table is used by IKJEGSYM in the first search in an attempt to 


resolve a symbolic address. 


The maximum symbol length at hexadecimal displacement 10 is eight characters. 





Dec. | Hex. Field : 
Disp. |Disp.| Field Name | Size Contents 
CHAIN 4 Points to next 
‘symbol table in 
storage. 


ADDRSYM Pointer to symbol 
location. 














la factor. 


| 12 | ¢ [ATTRLNTH ars 
| 14 | & [SYMLNGTH | 2 [Symbol length. 


SYMBOL Symbol in 
EBCDIC as 
entered in 
EQUATE 


subcommand. 






Referenced (Cleared 
by by 


ATTRTYPE as Internal 
,hexadecimal code 
‘related to the 
type of character | 
entered on the 
EQUATE 
subcommand. 

OO Character 
format. 
04 Hexadecimal 
format. 
08 Binary format. 
OC Instruction 
format. 
10 Fixed point, 
half-word format. 
14 Fixed point, 
half-word format. 
18 Floating point, 
full-word format. 
1C Floating point, 
double-word 
format. 
20 Address 
constant, A or Q 
format. 
24 Address 
constant, Y 
format. 
28 Address is 
base 
displacement 
format. 
30 Packed 
decimal format. 
34 Zoned decimal 
format. 

9 | 9 [ATTRMULT. 
















































3 
1 
1 
! 
| 
‘ 
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Subcommand Name Table (IKJEGSCD) 


SVC Information Block 


198 


TSO Test 


The subcommand name table contains one entry for each subcommand, except 
the assignment function. The table is used by both IKJEGMNL and IKJEGSTA. 
IKJEGMNL searches the table for a matching name when the user enters a 
subcommand. It uses the associated [D as an index to an entry in the SCPPAD 
table. The SCPPAD table entry points to a compressed BLDL entry in the BLDL 
table. IKJEGMNL expands the BLDL entry, then specifies the entry in a LINK 
macro that it issues. 


TEST’s STAE Exit routine uses the subcommand name table to obtain the name 
of the failing subcommand. It places the name of the subcommand in a first-level 
diagnostic message that it issues to the terminal. Figure 17 shows the 
subcommand name table format. 


1 Byte M Bytes 1 Byte N Bytes 8 Bytes 1 Byte 





M+N+2 M+N+10 


SS ee a ‘iter Ma 


Figure 17. Subcommand: Name Table Format 


This block is built by the SVC 61 routine (IGC0006A). The SVB is pointed to by 
the appropriate SVQ for the TCB under which the load module was fetched. SVC 
information blocks are searched by IKJEGSYM in an attempt to resolve a symbol, 
entry name, or offset belonging to a load module of the problem program. 


EBCDIC load 
name of the 
fetched module. 





Address at which 
module is 
fetched. 


Beginning of TTR. 


Module attributes 
byte 1. 

Can be entered 
again. 

Reusable. 
Overlay. 

Module to be 
tested. 

Only loadable. 
Scatter load 
format. 
Executable. 
Module contains 
a block of text 
without RLD 
items. 

Module contains 
multiple records 
with at least one 
block of text. 








Dec. | Hex. Field Referenced (Cleared 
Disp. | Disp.| Field Name | Size Set by by by 


17 |SVBATTR2 1 Module attributes 
byte 2. 
SVBLKEDF | reer Module can be 
processed by 
Linkage Editor F 
only. 
O....... | Module can be 
| processed by all 
levels of the 
Linkage Editor. 
SVBTEXTO Reece Linkage Editor 
assigned origin or 
first text block is 
zero. 
ho Renee Linkage Editor 
assigned origin of 
first text block is 
not zero. 
SVBEPO sl ree Entry point 
assigned by the 
Linkage Editor is 
zero. 
SVBNORLD | ....1.... |Module contains 
no RLD items. 
SVBNOLE ....1.... [Module cannot be 
reprocessed by 
the Linkage 
Editor. 
SVBSYM ....1.. |Module contains 
symbol records. 
SVBLEVF | ....... 1. |Module created 
by Linkage Editor 
F. 
SVBREFR Refreshable. 


SVBFLGS1 
SVBDDNME 
SVBLNKLB 


[ee | pee | 

























































DDname is present. 
Data set is 
LINKLIB. 
Reserved. 


Concatenation 





SVBDDNAM DD Name of data 
set from which 
the module is 


fetched. _ 


TCB address for 
fetched module. 





1C |SVBTCBPT 









20 |SVBLNKPT Address of next 
SVC information 

block, or contains 
zeros if this is the 


last block. 


Section 5: Data Areas 199 


SVC Information Block Queue Element 





This block is built by the sv¢ 61 :outine (IGCO006A). The SVC 61 routine is 
invoked from Contents Supervision when a load module has been fetched. If 


TEST has been invoked, SVC 


queued from the invoking task TCBTRN field. 


Field Name 


Dec. 
Disp. 











O |SVQLNKPT 4 













Contents 


Address of the 
next SVC queue 
dlock or zero. 








4 |SVOTCBPT 4 


Address of TCB 





for which this 
SVC queue block 
exists. 





SVOBLKPT 4 








Hex. 
Disp. 


Symbol Information Block 
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A symbol information block (SiB) is created only by IKJEGSYM. SIBs are chained 







information block queue elements are queued from 
the TSTTRN field in TCOMTAB. [f TEST has not been invoked, these elements are 

















Address of ie 
queue of SVC 
information 

bloc ks for this 












from the SICHAIN field in TCOMTAB as they are built. When a subcommand 


processor returns to IKJEGMNL, it frees all SIBs and they are not available to the 


next subcommand processor. 


Dec. | Hex. Field 
ey Disp.| Field Name | Size 


So caews 4 


aT i | 
oh. 


MULTIPLT 3 








RESERVD1 
NEXTANSB 4 





Contents 


Pointer to een 
location. _ 


esa blse. 
created attribute 
code. 


Assembler- 
created 


multiplicity factor. 


ee iat 
Set PY: 











Assembler- 
created length 
attribute. 


Reserved. 


Pointer to SIB or 
contains zeros if 
this is the last 


SIB. 


J 





J 


TEST Communication Table (TCOMTAB) 


This table is built by IKJEGINT, is used by many TEST modules, and 1s freed by 
IKJEGMNL. 


c Dec. | Hex. Field Referenced |Cleared 
Disp. |Disp.| Field Name | Size (Contents by by 


hte ECBPP ECB waited on by - 


SVC 97 and SVC 


61. 
iy _ 
ECBTMPS 




























Beginning of ECB 
list for wait. 


Pointer to ECB 
posted by SVC 
97 and SVC 61. 


Pointer to ECB 
posted by 
completion of 
oldest subtask of 
TEST. 


Pointer to posted 
by TMP STAI Exit 
Routine at 
ABEND of any 
subtask of TEST. 


Pointer to ECB 
posted by TMP 
Attention Exit 
Routine or TEST’s 
Attention Exit 
Routine. 


ECBTMPA 


“ ECBLOG 
i 





Pointer to ECB 
posted by 
STOP/ MODIFY 
TS operator 
command. 


0 Pointer to TCB 
for TMP/TEST 
task. 


C 





TSTTCB 





ae Reserved. 


Pointer to TCB 


TSTTCBR 
TSTTCPB 


PPTCB 


c lpPTCcBR 
PPTCBP 


for TMP/TEST 
task. 


‘ 
‘ 










Pointer to TCB 
for problem 
program task 
currently 














Reserved. 


axe 





Pointer to TCB 
for problem 
program task 
currently 
qualified. 


Pointer to small, 
general purpose 
work area used 


OUTBUF 


as an output 
buffer for 


messages or 
data. 





a 
| eee 
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Dec. | Hex. Field Referenced |Cleared 
Disp. ;Disp.| Field Name | Size |Contents Set by by by 


a -_ 
2C |CONAREA 
(see 


WORKAREA 
TSTCWORK). 
REGSAVE* Pointer to register 
save area for 
ee ee IKJEGMNL. 
REGSAVE2 Pointer to register 
save area for 
TEST 
subcommands. 


Address of build 
area used by 
IKJEGINT and 
IKJEGLDR. 


Pointer to small 
work area in 
which IKJEGCVT 
returns converted 
values. 











Pointer to a 
general work area 
with general and 
reserved sections 









3C |REGSAVE3 Pointer to register 
save area 
reserved for 
subcommand 
validity check exit 


routines. 


REGSAVE4 Pointer to register 
Save area 
reserved for 


IKJEGCVT. 


Pointer to register 
save area 
reserved for 
IKJEGIO. 


Pointer to register 
save area 
reserved for 
IKJEGSRH. 







REGSAVES 


REGSAVE6 





[tan 


Communication 
word used for 
information 
passed from 
IKJEGSYM to 
IKJEGWHR. 







Logical line size 
of the user's 
terminal. 

Full byte queuing 
switch to force 
POSTs from SVC 
61 or SVC 97 
into FIFO order. 
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Dec. | Hex. Field Referenced (Cleared 
Disp. |Disp.| Field Name | Size |Contents by by 


nye _ 
96 Se Se TSTECT | Pointer to ECT. 
100 TSTCPECB Pointer to ECB 
(save ECB 
pointed to by 
ECBTMPA). 
104 


68 |TSTANSPL Answer field used 
by all modules 
calling IKJPARS 

ABENTAB Pointer to list that 
contains 
addresses of 
instructions in 
resident TEST 
modules where 
an ABEND is 
possible. 

ABENTAB1 Pointer to list that 
contains 
addresses of 
instructions in 
transient TEST 
modules where 
an ABEND is 
possible. 





Standard section 
of TMP Service 


Routine 
parameter list. 





i) 


~ ~ ~ oz) 


08 


oO 













5S 






TSTRETRY STAE retry 


communication 
74 |TSTRTYCD 


word. 

TSTRTYPT : Pointer to a STAE 
retry routine 
within any TEST 
module currently 
in control that 
has issued a 
STAE macro 
instruction. 


Pointer to storage 
containing a 
subcommand 
ready for 
processing. 
TSTIODSN Pointer to queue 
of DSNAMEs 
used as 
parameters for 
PRINT keyword 
with LIST TYPE 
subcommands. 





117 





co 


C 





subroutine in 


Pointer to 
PUTLINE 
subroutine in 
IKJEGIO. 





TGETADDR Pointer to 
GETLINE 
TPUTADDR 


~J 
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| Dec. | Hex. Field Referenced |Cleared 
Diap.|Disp.| Field Name} Size by by 


TPUTGET Pointer to 
PUTGET 
subroutine in 

! IKJEGIO. 
he : 


8C |TSTCONVT Pointer to 
— IKJEGCVT. 


90 ;TSTADDR 4 













Pointer to 
IKJEGBLD, a 
subroutine whose 
function is to 
assembly an 
EBCDIC address 
string from the 
components 












Pointer to 


IKJEGSTA. 
Nise erates byte 1. 
PCHLSTVL - 
IKJEGPCH is 
processing a list 
of values. 
TSTPRINT - 
output from 
IKJEGIO is to a 
data set. 
TSTFIRST - 
general purpose 
switch for use by 
any subcommand 
or subroutine. 
Not to be passed. 
RANGESW - 
indicates a 
“range” address 
parameter. 
TSTBUILD - 
indicates that a 
new module is 
being loaded for 
the problem 
program. 
ENDSW - 
indicates END 
processing has 
begun. TMP will 
force DETACH. 
RUNSW - 
indicates RUN. 
TMP will not 
force DETACH. 
Reserved. 

















































Dec. | Hex. Field Referenced |Cleared 
Disp. |Disp.| Field Name | Size (Contents by by 


| 


| 3 





9A |TSTFLGS3 


eeeeane 











Switches, byte 2. 
TSTLDFE - 
indicates 
IKJEGLDF is 
running under 
subtask TCB. 
TSTXCTL - 
indicates that 
subcommand 
processor has 
issued an XCTL 
macro instruction. 
TOFFDEF - 
internal switch 
TTESTTCB - not 
used. 
TADDROUT - 
internal switch 
internal switch 
used by 
IKJEGOFF. 
TYMIOMST - 
internal switch 
used by IKJEGIO. 
Reserved. 
Switches, byte 3. 
TSTGOSW - 
indicates a 
pseudo 
breakpoint set by 
IKJEGLDR at 
entry point of the 
problem program. 
TSTSTAI - 
indicates that a 
task of the 
problem program 
has begun to 
ABEND. 
SYMMESG - 
indicates that 
IKJEGSYM is to 
write no 
diagnostic 
messages. 
TCSECTCK - 
internal switch 
used by 
IKJEGOFF. 
TDUPNAME - 
internal switch 
used by 
IKJEGOFF. 
TSTLINK - 
internal switch 
used by 
IKJEGMNL. 
TSTHELP - 
indicates that the 
HELP command 
processor has 
been ATTACHed. 
NOPARMS - 
indicates 
subcommand 
entered without 
operands. 
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TSTGOWCF Wait count from 
RBWCF for a 
module of the 
problem program 
when a pseudo 
breakpoint has 
| been set. 


Field Referenced (Cleared 
Size (Contents by 


Switches, byte 4. 

























c 


TSTA - indicates 
input from the 
terminal. 

TSTB - indicates 
a terminal 
element has been 
added to the 
input stack. 
TSTFLUSH - 
indicates to 
IKJEGMNL that 
the TCLEARQ 
macro instruction 
should be issued 
to purge input 
buffers. 
Reserved. 





4 Origin or active 
break element 


SC BREAKTAB 
queue. 
DEFERTAB re of defer 
re queue. 


PPLOAD Base address for 
relative 
addresses. 

2 Contains the 
loaded address of 
the currently 
testable module. 

in or 


172 | AC |SUBCHAIN Pointer to in-core 
subcommand 
which is part of a 
chain associated 
with a breakpoint 
element. 


TSTGO Area used for 
breakpoints. 


handling pseudo 
TSTGOPSW A 4-byte save 
area used for 
pseudo 
breakpoints. It 
contains either 
the first two 
bytes of the 
problem 
program’s entry 
point instruction 
when TSTGOSW 
contains °’1°’B or 
the problem 
program's saved 
restart address 
(RBOPSW +4) 
when TSTGOSW 
contains ‘O’B. 





Temporary base 
for relative 
addresses. 

















< 








Dec. | Hex. Field Referenced |Cleared 
Disp. |Disp.| Field Name | Size |Contents ‘Set by by by 


rstasvoz | 1... [Reseed | || 


ey 7 an 
wl : 


188 | BC |TSTIODCB 


Contains an SVC 
97 instruction 
(X‘O0A61° that is 
executed to cause 
a pseudo 
breakpoint to be 
taken. 


Pointer to PRB 
for problem 
program module 
that is currently 
qualified. 


Pointer to DCB 
opened to write 
to a data set 
specified in a 
PRINT keyword 
parameter. 




















CO |CALLPARM Head of chain of 
CALL parameter 
lists built by 
IKJEGGO when it 
is entered at 
entry point 
IKJEGCAL. 


Reserved. 


EBCDIC name of 
currently qualified 
load module. 


EBCDIC name of 
currently qualified 
CSECT. 


Base address for 
symbolic 
addresses. 
















C8 |TSTCURLD 


TSTCURCT 


TSTSYMBA 


aS 
















~) 
oO 
— 
: 
av 
z 


Pointer to chain 
of control words 
built by IKJEGINT 
from information 
supplied by the 

SVC 61 routine 

(see IKJEGSVQ). 


Pointer to symbol 
information block 
(SIB) queue built 
by IKJEGSYM. 


Pointer to work 
area acquired for 
symbol 
processing. 






SICHAIN 





TSTSYMWK 


SYMTABLE Pointer to queue 
of table elements 
built by 


IKJEGEQU. 


Contains SVC 
instructions. 
Contains an SVC 
97 instruction 
(x’°0A61'). 


PPEXIT2 Contains an SVC 


mi 
oO 


PPEXIT 


m 
2) 


PPEXIT1 





3 instruction 
(x‘0A03'). 
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Dec. | Hex. Field Referenced (Cleared 
Disp. |Disp.| Field Name Size /|Contents by by 


240 TSTDCB Pointer to queue 
of DCBs . } 
maintained in 
overlay mode. 
OPCODTAB Pointer to table of 
valid operation 
" -_ u 


codes. 
TSTSVCQ 


- 











Pointer to table of 
valid $/370 
two-byte 
operation codes. 


Pointer to queue 
of ECBs which 
order breakpoints 
in FIFO sequence 
in a multi-tasking 
environment. 


Pointer to 
common 
subroutine to 
handle error 
conditions 
returned by 


TSTHTCB 


ial | 


TSTAQLDM 


Pointer to TCB 
for HELP 
subcommand. 


Automatic 
qualification 
information. 


EBCDIC load 
module name of 
the load module 
that IKJEGMNL 
last automatically 
qualified. 





TSTAQEP Pointer to entry 
point of the load 
module that 
IKJEGMNL last 
automatically 


qualified. 











Pointer to retry 
routine that is 
executed after a 
STAE exit routine 
intercepted an 
ABEND in the 
TEST program. 


276 im 





TSTSRHR Address of 
resident 
breakpoint Search 
routine. 

11C |TSTSTAX 


TEST 
dispatchability 
ECB. 


IKJEGMNL work 
area. 


STAE parameter 


—= 
© 
be) 


STAX parameter 
list. 


TSTDSECB 
- TSTMNLWK 


15C | TSTSTAE 





list for 
IKJEGMNL. 


feseved. [| i 





—_ 
~J 
© 


C 


TEST Parameter List (TPL) 


The TEST Parameter List is constructed by module IKJEI10l in the (MP. It is 
referenced by IKJEGINT directly, and by other TEST modules indirectly through 
TPL information placed in the TCOMTAB by TEST initialization. 


Dec. | Hex. | Field Name| Field Referenced (Cleared 
Pe Disp. Size (Contents a by 


i. eee Address of 


command buffer. 
wd 4 coll 


: | 
24 18 










Address of user 
profile table 
(UPT). 


Address of 
protected step 
control block 



















Address of . 
environment 


Add ress of 
attached 
command 
processor's TCB. 


Address of TMP 
STAI Exit routine. 


Address of STAI 
parameter list. 


Address of ECB 
for a terminating 
command 
processor. The 
TMP STAI Exit 
routine 
(IKJEGTO4) waits 
on the ECB. 


Address of TCB 
for a terminating 
command 
processor or 
problem program. 






















Section 5: Data Areas 209 


210 TSO Test 


Dec. Hex. |Field Name| Field Referenced |Cleared 
E ee Disp. Size (Contents by by 





Address of 
STOP/MODIFY 
ECB. Equivalent 
of ECBLOG in the 
TCOMTAB. 


2€ |TPLCECB Address of 
attached 
command 
processor's ECB. 
Posted by 
supervisor's EOT 
routine when 
command 
processor (or 
problem program) 
completes 
normally. 
Equivalent of 
ECBTERM in 

i Address of TMP 


7 é : 
TPLAECB Address of TMP’s 
attention ECB. 
Equivalent of 
ECBTMP in 


























Equivalent of 
ECBTMPA in 










TMP STAI Exit 
routine. 

command library 
DCB. 






Posted by the 
TPLLDCB Address of 









C - 


TEST’s Work Area (TSTCWORK) 


TSTCWORK, the permanent work area, is acquired at initialization by IKJEGINT . 
Partition control of the various sections is done by the macro TSTCWORK. 


Dec. | Hex. | Field Name| Field Referenced (Cleared 
Disp. | Disp. Size |Contents by by 


CWORKCVT Work area for use|/IKJEGCVT |IKJEGCVT 
only by 
CWORKCM 
IKJEGMNL, 
IKJEGINT 


IKJEGCVT. 
232 CWORKIO Work area for use IKJEGIO 
only by IKJEGIO. 


264 | 108 |CWORKAT 64 {Work area for use IKJEGATN 
only by 
IKJEGATN. 


Work area for use 


only by 
IKJEGSTA. 



















IKJEGMNL |IKJEGINT 










Work area for use 
only by 
processors. 


Command 
processors 

























1AC |CWORKSTA IKJEGSTA 


ins a on Za _ 


Note: IKJEGINT and IKJEGLDR may use TSTCWORK, because other modules that 
use it are not yet in main storage. 


428 














Work area for use 
only by 
IKJEGSYM. 
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Section 6: Diagnostic Aids 


This section contains information on how IKJEGMNL handles STAE-intercepted 
abnormal terminations that occur in the TEST program. 


Passing control to TEST 


Figure 18 shows why IKJEGMNL received control, who from, and the resultant 
processing. 


Event and Routine that passed |Pointer to |Resultant Processing by IKJEGMNL 
Control the ECB in 
TCOMTAB 


ee ee py nn ne 
A. (1) SVC 97 routine ECBTST |1. IKJEGMNL automatically qualifies 

the problem program to the currently 
eoriaatay Cede Speer executable load module, if a new RB or 


breakpoint. |GCOOQO9G issues BOB op acive: 
a POS/VS2T macro . It then determines the type of 
instruction to set | breakpoint that the program executed. 


IKJEGMNL's ECB. . If a user breakpoint was encountered, 


IKJEGMNL issues an AT message, 
updates the SUBCHAIN pointer in 
TCOMTAB from the current break 
element, and branches to location SCREQ 
to get a new subcommand 





. If, however, a pseudo breakpoint was 
encountered, IKJEGMNL restores the 
saved program restart address and 
registers, and branches to location SCREQ 


( to get a new subcommand. Two special 





pseudo breakpoints receive unique 
treatment. One is set by IKJEGLDF during 
the processing of a LOAD, DELETE, 
GETMAIN, or FREEMAIN subcommand. 
The other special pseudo breakpoint is set 
by IKJEGINT to handle the exit from the 
problem program when the program 
completes (see event A(1))}. 
A. (2) The problem program has | ECBTST /|IKJEGMNL sets the problem program's 
completed its execution restart address to that of an SVC 3 
normally. A special pseudo instruction to enable the program to exit via 
breakpoint (set by IKJEGINT) the supervisor's exit routine. IKJEGMNL 
is encountered. |GCOOO9G issues the message, ““PROGRAM UNDER 
issues a POS/VS2T macro | TEST HAS TERMINATED NORMALLY ” It 
instruction to set then branches to location SCREQ to 
IKJEGMNL’s ECB. determine what subcommand the user wants 
to enter If the user enters GO, CALL, or 
RUN without operands, the problem program 
exits. However, if the user enters GO, CALL, 
or RUN with an operand, the restart address 
is altered by IKJEGGO, and the problem 
- program continues to execute. 








. I1GCOOOGA has received ECBTST |IKJEGMNL determines if there are any 
control from Contents deferred breakpoints that have to be 
Supervision or the overlay activated in the newly fetched module by 
supervisor during the fetch of testing the defer element queue origin 
a load module of the problem (DEFERTAB) in TCOMTAB. If there are any 
program. IGCOOO6A issues a deferred breakpoints, IKJEGMNL links to the 
POST macro instruction to AT subcommand processor to set the 
set IKJEGMNL’s ECB. breakpoints. It then issues a POST macro 

instruction to set |GCOOQOQ6A to restart the 

problem program. Otherwise, IKJEGMNL 
merely posts |GCOOO6A and does not link to 


| the AT subcommand processor 


Figure 18. (Part 1 of 2) Passing Control to TEST 
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C. The problem program has 


begun to terminate 
abnormally. The TMP’s STAI 
Exit routine, IKJEFTO4, has 
been entered from the 
ABEND /STAE Interface of 
the supervisor. 


IKJEFTO4 issues a POST 
macro instruction to allow 
TEST to retry. 


. The problem program has 


completed normal 
termination. The supervisor 
EOT routine issues a POST 
macro instruction to set the 
termination’s ECB. 


. Operator has issued a STOP 


TS or MODIFY TS command 
to set the LOGON/LOGOFF 
Scheduler’s ECB using a 
POST macro instruction. 
IKJEGMNL tests this ECB as 
part of its ECB list. 


. The user enters or simulates 


two successive attention 
interruptions, while the 
problem program is running. 
He enters an input line other 
than °’?” or a carrier return. 
The TMP Attention Exit 
routine, IKJEFTO3, issues a 
POST macro instruction to 
set the attention ECB. 


the ECB in 
TCOMTAB 





ECBTM PS 


ECBTERM 


ECBLOG 


ECBTMPA 





Event and Routine that passed |Pointer to |Resultant Processing by IKJEGMNL 
Control 


IKJEGMNL saves the problem program's 
registers and restart address. It then issues a 
POST macro instruction to set an ECB on 
which the TMP STAI Exit waits, specifying a 
retry code (X‘7F’) and passing the retry 
address. The retry address is TSTGO +6, the 
location of a pseudo breakpoint instruction. 
When the ABEND/STAE Interface regains 
control from the STAI Exit, it obtains linkage 
to the pseudo breakpoint (an SVC 97 
instruction). When the SVC 97 routine has 
handled the breakpoint (event A), IKJEGMNL 
regains control to get a new subcommand 
from the terminal. 





IKJEGMNL issues the message, “PROGRAM 


UNDER TEST HAS TERMINATED.” It then 
branches to location ENDIT1 to clean up 
TEST and return to the TMP. 


This processing can occur only when there 
are no more RBs queued from TESTs subtask 
TCB. 


IKJEGMNL branches to location ENDIT1 to 
clean up TEST and return to the TMP. As a 
result, the LOGON/LOGOFF Scheduler logs 
off the terminal user. 


IKJEGMNL assumes that the IKJEFTO4 
issued a POST after an ABEND in the 
problem program. |KJEGMNL branches to 
IKJEGIO to issue a termination message. 
IKJEGIO tests the attention ECB, detects the 
attention interruption, does not issue the 
message, and returns to IKJEGMNL with a 
return code of 16, indicating that an attention 
interuption has been detected. IKJEGMNL 
tests the post code in the attention ECB and 
determines that the TMP, not TEST, was 
posted. IKJEGMNL then branches to location 
ENDIT1 to clean up TEST and return to the 
TMP. The TMP will invoke the new 
command processor that the user requested 
when he entered the attention interruption. 


Figure 18. (Part 2 of 2) Passing Control to TEST 


J 


J 


C 


ABEND Handling in TEST 


When IKJEGMNL encounters an ABEND in TEST, RETRY (the retry routine) frees 
the 104-byte STAE work area, if it exists. IKJEGMNL issues a STAE macro 
instruction to set up and queue a STAE control block (SCB). These actions 
establish TEST’s STAE Exit routine. 


If location TSTRSTRT in TCOMTAB contains a nonzero value, IKJEGMNL 
branches to the address contained at TSTRSTRT. When TSTRSTRT contains zeros, 
IKJEGMNL determines if END processing has begun. If END has begun, 
IKJEGMNL branches to location TMPRTURN, cleans up the TEST command 
processor, and returns to the TMP. Otherwise, IKJEGMNL’s retry routine 
completes retry processing according to the type of error that caused the ABEND, 
as follows: 


e« If ATTACH of the Help command processor failed, [KJEGMNL issues the 
““HELP FAILED” message and branches to location SCREQI to get a new 
subcommand. 


e If an error occurred in IKJEGMNL itself, it branches to location ENDIT1, cleans 
up the TEST command processor and returns to the TMP. 


e If a second LINK to the same subcommand processor failed, IKJEGMNL issues 
the “LINK TO SUBCOMMAND FAILED“ message, branches to ENDIT1, cleans 
up the TEST command processor, and returns to the TMP. 


e If a subcommand processor failed transferring control to another subcommand 
module, IKJEGMNL branches to location SCREQ! to get a new subcommand. 


e If a link to a subcommand processor failed because of an I/O error during its 
fetch and a module of the problem program was being fetched concurrently, 
IKJEGMNL issues the “LINK TO SUBCOMMAND FAILED” message. It then branches 
to location IKJEGCTL which posts control back to the SVC 61 routine. The SVC 
routine continues the processing of the fetched module. 


e If a link to a subcommand processor failed because of an I/O error during its 
fetch, and a module of the problem program was not being fetched 
concurrently, IKJEGMNL issues the “‘ LINK TO SUBCOMMAND FAILED” 
message and branches to location SCREQ/ to get a new subcommand. 


Special Error Termination Processing 


For an error condition that requires a return to the TMP, TEST modules return to 
IKJEGMNL to conditionally flush the input stack and clear input buffers. 
IKJEGMNL conditionally removes non-terminal elements from the input stack (via 
the Stack service routine) and clears TCAM and time-sharing control buffers (via 
the TCLEARQ macro instruction). IKJEGMNL causes this cleanup before it returns 
to the TMP. (See the TSTFLUSH bit in the TSTFLGS4 field in TCOMTAB.) 
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Section 7: Appendix 


C 


Setting Pseudo Breakpoints 


TEST Module Special Condition That Processing by TEST Module 
That Sets the Exists when Breakpoint 

Pseudo is Set 

Breakpoint 


1. IKJEGLDR Problem program has been |IKJEGLDR saves the first two bytes of the 
loaded by the OS/VS2 problem program’s entry point instruction at 
Loader. location TSTGO in TCOMTAB. It places an 
SVC 97 instruction at the problem program's 
entry point. IKJEGLDR turns on the 
= TSTGOSW flag in the TSTFLG3 field of 
TCOMTAB, and then issues an XCTL macro 
instruction to the program's entry point to 
execute the breakpoint. IKJEGINT will 
restore the first two bytes of the program's 
entry point instruction when control is passed 
to it from |GCOO09G after the breakpoint is 
taken. 


2. IKJEGLDR IKJEGLDR is about to Processing is the same in number 1. If the 


invoke a load module of desired load module is in system-protected 
the problem program. The |storage, a program check occurs when 
module is already in main |IKJEGLDR issues the XCTL macro 


storage. instruction. 
3. IKJEGLDR IKJEGLDR is about to IKJEGLDR turns on the TSTGOSW flag in 
invoke a load module of the TSTFLG3 field of TCOMTAB, which 
the problem program. The |indicates a pseudo breakpoint is set at the 
, module is not in storage problem program’s entry point. (The actual 
4 and will be fetched via an. _|breakpoint is set by IKJEGINT as in number 


XCTL macro instruction. 1 when IKJEGINT temporarily gets control 
during the fetch process.) 


4. IKJEGINT TEST has been entered IKJEGINT moves the problem program's 

because a subtask of the [restart address in the TSTGO field of 

TMP has started to TCOMTAB. The saved address is the 

terminate abnormally. RBOPSW +4 field in the current PRB or IRB 
or the terminating task. IKJEGINT passes to 
the TMP STAI Exit routine a retry address 
(TSTGO+6) that contains an SVC 97 
instruction. 
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TEST Module 
That Sets the 
Paaudo 
Breakpoint 


5. IKJEGINT 


6. IKJEGMANIL 


7. IKJEGATN 


8. IKJEGLDF 


9. IKJEGQFY 


10. IKJEGINT 


Special Condition That 
Exists when Breakpoint 
is Set 


TEST has been entered 
because a subtask of the 
TMP has been interrupted 
by an attention 
interruption. 


An ABEND has occurred 
during execution of the 
problem program or the 


HELP command processor. 
IKJEGMNL received contro! 


from the TMP STAI Exit 
routine. 





The user has entered or 
simulated an attention 
interruption during the 
TEST session. 


IKJEGLDF needs to force a 


task switch from the 
subtask to the TEST task. 


Processing by TEST Module 








IKJEGINT saves the problem program's 
restart address in the TSTGO field of 
TCOMTAB. The saved address is the 
RBOPSW +4 field in the current PRB or IRB 
of the oldest program task. IKJEGINT 
changes the RBOPSW-+4 field to point to 
TSTGO+6, that contains an SVC 97 
instruction. 


IKJEGMNL sets a pseudo breakpoint as in 
number 4. 





An Attention Exit routine sets a pseudo 
breakpoint as in number 5. 


restart address in the TSTGO field of 
TCOMTAB. It then points the problem 
program’s RBOPSW +4 field to a part of 
IKJEGLDF that is to be executed under the 
subtask. When this part of the module 
completes, IKJEGLDF branches to location 
TSTGO+6 to execute the pseudo breakpoint. 


IKJEGQFY sets a pseudo breakpoint as in 
number 5. 


IKJEGINT sets a special pseudo breakpoint 
to permit the SVC 97 routine and IKJEGMNL 
to detect the problem program's completion. 
IKJEGINT points the saved problem program 
register 14 to an SVC 97 instruction at 
location PPEXIT in TCOMTAB. When 
executed, this pseudo breakpoint is 
recognized by both the SVC 97 routine and 
IKJEGMNL because of its unique location in 
TCOMTAB. 
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text description of . 

IKJDAIR (Dynamic Allocation Interface service 

routine) 
usc in TEST... 

IKJEFTO4, TMP STAI Exit routine. 
posting, diagram of 

IKJEGASN, Assignment function processor, ‘second 

load module 

(see also IKJEGPCH) 
diagram of 
module description of 
text description of . 

IKJEGAT, AT subcommand processor, first. 

load module 

(see also IKJEGATD) 

Aj agram of 
me ‘ale description of 
teat description of 

IKJEGATD, AT subcommand processor, second 

module 
diagram of 
module description of 
text description of 2... 

IKJEGATN, Attention Exit routine 
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module description of 
text description of . . . 354 
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module description ii 
text description of . ; 

IKJEGCIV, HELP command processor 
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interrupted by an attention interruption 
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module description of 
text description of . : 

IKJEGCPY, COPY subcommand processor 
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module description of 
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module description of 
text description of . . : 

IKJEGDEL, Delete subcommand processor 

(see also IKJEGLDF) 
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module description of 
text description of . 

IKJEGDRP, Drop subcommand processor 
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text description of . 
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IKJEGFRE, FREEMAIN subcommand processor 
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IKJEGIO, I/O module 
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